Miyabi MCP Bundle

The Ultimate MCP Server for Claude Code & AI CLI Agents

172+ MCP Tools | Enterprise Security | Zero Config

Installation | Quick Start | Tools | Configuration

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

# npm
npm install -g miyabi-mcp-bundle

# Run setup wizard
miyabi-mcp init

Quick Start

Claude Code Configuration

Add to ~/.claude/claude_code_config.json:

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

Claude Desktop Configuration

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

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

Tools

Categories (21)

| 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 |

Example Usage

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

Configuration

Environment Variables

| 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 |

CLI Commands

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

# 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

Part of the Miyabi Framework

Made with love by Shunsuke Hayashi

@The_AGI_WAY | note.ambitiousai.co.jp