┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   ███╗   ███╗██╗██╗   ██╗ █████╗ ██████╗ ██╗                   │
│   ████╗ ████║██║╚██╗ ██╔╝██╔══██╗██╔══██╗██║                   │
│   ██╔████╔██║██║ ╚████╔╝ ███████║██████╔╝██║                   │
│   ██║╚██╔╝██║██║  ╚██╔╝  ██╔══██║██╔══██╗██║                   │
│   ██║ ╚═╝ ██║██║   ██║   ██║  ██║██████╔╝██║                   │
│   ╚═╝     ╚═╝╚═╝   ╚═╝   ╚═╝  ╚═╝╚═════╝ ╚═╝                   │
│                                                                 │
│    The All-in-One MCP Server for Claude Desktop  v3.7.0        │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

✨ Why Miyabi?

Miyabi (雅) - Japanese for "elegance" and "refinement"

Transform your Claude Desktop into a powerful development command center with the most comprehensive MCP server available:

📊 Comparison with Other MCP Servers

📦 Installation

Quick Start (Recommended)

# Interactive setup wizard (generates Claude Desktop config automatically)
npx miyabi-mcp-bundle init

Global Installation

npm install -g miyabi-mcp-bundle

# Run the setup wizard
miyabi-mcp init

# Or diagnose your setup
miyabi-mcp doctor

CLI Commands

⚙️ Claude Desktop Setup

Option 1: Automatic Setup (Recommended)

npx miyabi-mcp-bundle init

The setup wizard will:

1. Check prerequisites (Node.js, npm, git)
2. Ask for your repository path
3. Optionally configure GitHub token
4. Generate Claude Desktop configuration automatically

Option 2: Manual Setup

Add to your Claude Desktop configuration:

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

🚀 Quick Start

After configuration, try these commands in Claude Desktop:

📊 "Show me the system resources"
🔀 "What's my git status?"
📁 "List recently changed files"
🐛 "Search logs for errors"
🐙 "Show open GitHub issues"

🛠️ Complete Tool Reference

🔒 Security

Miyabi implements enterprise-grade security to protect your system:

🛡️ Input Sanitization

// All shell commands are sanitized to prevent injection
sanitizeShellArg(input)  // Removes dangerous characters
sanitizePath(basePath, userPath)  // Prevents path traversal
isValidHostname(host)  // Validates network targets
isValidPid(pid)  // Validates process IDs

🔐 Security Features

✅ Safe by Default

• All operations use secure defaults
• No dangerous operations without explicit confirmation
• Input validation on all user-provided data
• Error messages don't leak sensitive information

🔌 Plugins

This package includes the complete Miyabi plugin ecosystem:

Plugin Installation

Plugins are included in plugins-unpacked/ directory when installed via npm:

# Access plugins after npm install
ls node_modules/miyabi-mcp-bundle/plugins-unpacked/

🏗️ Architecture

┌────────────────────────────────────────────────────────────┐
│                    Claude Desktop                          │
└─────────────────────────┬──────────────────────────────────┘
                          │ MCP Protocol
                          ▼
┌────────────────────────────────────────────────────────────┐
│                 Miyabi MCP Bundle                          │
│  ┌──────────────────────────────────────────────────────┐  │
│  │                   Tool Router                        │  │
│  └──────────────────────────────────────────────────────┘  │
│      │        │        │        │        │        │        │
│      ▼        ▼        ▼        ▼        ▼        ▼        │
│  ┌──────┐┌──────┐┌──────┐┌──────┐┌──────┐┌──────┐        │
│  │ Git  ││ Tmux ││ Log  ││Resource││Network││GitHub│  ...  │
│  │ 10   ││  9   ││  6   ││   8   ││   8   ││  12  │        │
│  └──────┘└──────┘└──────┘└──────┘└──────┘└──────┘        │
└────────────────────────────────────────────────────────────┘

👨‍💻 Development

# Clone the repository
git clone https://github.com/ShunsukeHayashi/miyabi-mcp-bundle.git
cd miyabi-mcp-bundle

# Install dependencies
npm install

# Development mode (with hot reload)
npm run dev

# Build for production
npm run build

# Run linter
npm run lint

# Run tests
npm test

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

MIT © Shunsuke Hayashi

✨ Miyabiとは？

雅 (Miyabi) - 洗練された優美さを意味する日本語

Claude Desktopを強力な開発コマンドセンターに変換する、最も包括的なMCPサーバーです。

🎯 特徴

• 🚀 172 MCPツール を21カテゴリ + ヘルスチェックに統合
• 🔐 エンタープライズグレードのセキュリティ - インジェクション対策、パストラバーサル防止
• ⚡ インテリジェントキャッシュ - 高速レスポンス
• 38 AIエージェント - コード生成、レビュー、デプロイ等
• 22 開発スキル - Rust、Git、TDD、セキュリティ等
• 56 スラッシュコマンド - デプロイ、PR作成、Issue管理等
• 24 フック - 自動フォーマット、バリデーション等
• 設定不要 - すぐに使える
• 本番環境対応 - 実際の開発環境でテスト済み

📦 インストール

# npx（推奨）
npx miyabi-mcp-bundle

# グローバルインストール
npm install -g miyabi-mcp-bundle

⚙️ Claude Desktop 設定

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

🚀 クイックスタート

設定後、Claude Desktopで以下を試してください：

📊 「システムリソースを表示して」
🔀 「gitの状態を確認して」
📁 「最近変更されたファイルを見せて」
🐛 「エラーログを検索して」
🐙 「GitHubのIssue一覧を表示して」

🛠️ ツールカテゴリ