---

Target Users

- Claude Code (Anthropic's official CLI)
- OpenAI Codex CLI
- AI Agent developers building LLM-powered tools

Features

- 172+ MCP Tools across 21 categories
- Enterprise-grade Security: Input sanitization, path traversal protection
- Intelligent Caching: Built-in LRU cache with TTL support
- Cross-Platform: macOS, Linux, Windows support
- Zero Configuration: Works instantly out of the box

---

Installation

``bash


npm

npm install -g miyabi-mcp-bundle

Run setup wizard

miyabi-mcp init
`

---

Quick Start

$3

Add to ~/.claude/claude_code_config.json:

`json
{
"mcpServers": {
"miyabi": {
"command": "npx",
"args": ["-y", "miyabi-mcp-bundle"],
"env": {
"MIYABI_REPO_PATH": "/path/to/your/repo",
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}
`

$3

Config File Locations:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/claude/claude_desktop_config.json

`json
{
"mcpServers": {
"miyabi": {
"command": "npx",
"args": ["-y", "miyabi-mcp-bundle"],
"env": {
"MIYABI_REPO_PATH": "/path/to/your/repo",
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}
`

---

Tools

$3

| Category | Tools | Description |
|----------|-------|-------------|
| Git | 12 | Repository operations |
| GitHub | 15 | Issues, PRs, Labels, Milestones |
| System | 8 | CPU, Memory, Disk monitoring |
| Process | 8 | Process management |
| Network | 8 | Network diagnostics |
| File | 6 | File watching & stats |
| Log | 6 | Log aggregation |
| Tmux | 11 | Session management |
| Docker | 12 | Container management |
| Kubernetes | 10 | K8s operations |
| Claude | 8 | Claude Code integration |
| Database | 6 | SQLite, PostgreSQL, MySQL |
| Time | 4 | Time utilities |
| Calculator | 4 | Math operations |
| MCP | 4 | Tool discovery |
| Health | 4 | System health checks |

$3

`
"Show git status"
"List open GitHub issues"
"Check system resources"
"Show Docker containers"
"Search logs for errors"
`

---

Configuration

$3

| Variable | Default | Description |
|----------|---------|-------------|
| MIYABI_REPO_PATH | cwd() | Git repository path |
| MIYABI_LOG_DIR | Same as repo | Log directory |
| MIYABI_WATCH_DIR | Same as repo | File watch directory |
| GITHUB_TOKEN | - | GitHub Personal Access Token |
| GITHUB_DEFAULT_OWNER | - | Default repo owner |
| GITHUB_DEFAULT_REPO | - | Default repo name |

$3

`bash
miyabi-mcp init # Setup wizard
miyabi-mcp doctor # Diagnose issues
miyabi-mcp info # System information
miyabi-mcp # Start server
`

---

Security

- Input sanitization for all user inputs
- Path traversal protection
- Symlink attack prevention
- Command injection prevention
- Secure defaults

---

Development

`bash


Clone from monorepo

git clone https://github.com/ShunsukeHayashi/Miyabi.git
cd Miyabi/packages/mcp-bundle

Install dependencies

pnpm install

Development

pnpm run dev

Build

pnpm run build

Test

pnpm test
``

---

License

MIT - See LICENSE

---

Links

- GitHub Repository
- npm Package
- Report Issues

---