🌸 Miyabi MCP Bundle

🚀 The Most Comprehensive MCP Server for Claude Desktop & AI Agents

🎯 172 MCP Tools · 38 Agents · 22 Skills · 56 Commands · 24 Hooks

⭐ If this helps you, please give it a star! It helps others discover this project.

Installation · Quick Start · Tool Reference · API Docs · Plugins · Security · 日本語

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   ███╗   ███╗██╗██╗   ██╗ █████╗ ██████╗ ██╗                   │
│   ████╗ ████║██║╚██╗ ██╔╝██╔══██╗██╔══██╗██║                   │
│   ██╔████╔██║██║ ╚████╔╝ ███████║██████╔╝██║                   │
│   ██║╚██╔╝██║██║  ╚██╔╝  ██╔══██║██╔══██╗██║                   │
│   ██║ ╚═╝ ██║██║   ██║   ██║  ██║██████╔╝██║                   │
│   ╚═╝     ╚═╝╚═╝   ╚═╝   ╚═╝  ╚═╝╚═════╝ ╚═╝                   │
│                                                                 │
│    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:

🎯 172 Tools in One Package

The largest collection of MCP tools: 172 Tools + 38 Agents + 22 Skills + 56 Commands + 24 Hooks.

⚡ Zero Configuration

Works instantly out of the box. Just add to Claude Desktop and go.

🔐 Enterprise-Grade Security

Input sanitization, path traversal protection, and secure defaults.

🚀 Intelligent Caching

Built-in caching system for faster responses and reduced API calls.

🌍 Cross-Platform

Seamlessly works on macOS, Linux, and Windows.

🏥 Health Check System

Comprehensive system health validation and diagnostics.

📊 Comparison with Other MCP Servers

| Feature | Miyabi | Other MCP Servers | |---------|:------:|:-----------------:| | Total Tools | 172 | 10-30 | | Security Sanitization | ✅ | ❌ | | Built-in Caching | ✅ | ❌ | | Health Check | ✅ | ❌ | | Cross-Platform | ✅ | Limited | | Plugin System | ✅ | ❌ | | Zero Config | ✅ | ❌ |

📦 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

| Command | Description | |---------|-------------| | miyabi-mcp init | 🚀 Interactive setup wizard | | miyabi-mcp doctor | 🔍 Diagnose setup issues | | miyabi-mcp info | ℹ️ Show system information | | miyabi-mcp --help | 📖 Show help | | miyabi-mcp | ▶️ Start MCP server |

⚙️ 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:

| OS | Path | |---|---| | 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_here"
      }
    }
  }
}

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

🚀 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

172 Tools Across 21 Categories + Health Check

| Tool | Description | |:-----|:------------| | git_status | Get current git status (modified, staged, untracked) | | git_branch_list | List all branches with remote tracking info | | git_current_branch | Get current branch name | | git_log | Get commit history | | git_worktree_list | List all git worktrees | | git_diff | Get diff of unstaged changes | | git_staged_diff | Get diff of staged changes | | git_remote_list | List all remotes | | git_branch_ahead_behind | Check commits ahead/behind origin | | git_file_history | Get commit history for a specific file | | git_stash_list | List all git stashes | | git_blame | Get blame info for files with line range | | git_show | Show commit details and diffs | | git_tag_list | List all tags with metadata | | git_contributors | Get repository contributors with stats | | git_conflicts | NEW Detect merge conflicts in worktree | | git_submodule_status | NEW List submodule status | | git_lfs_status | NEW Git LFS status (requires git-lfs) | | git_hooks_list | NEW List git hooks in repository |

| Tool | Description | |:-----|:------------| | tmux_list_sessions | List all tmux sessions | | tmux_list_windows | List windows in a session | | tmux_list_panes | List panes in a window | | tmux_send_keys | Send keys to a pane | | tmux_pane_capture | Capture pane content | | tmux_pane_search | Search pane content | | tmux_pane_tail | Get last N lines from pane | | tmux_pane_is_busy | Check if pane is busy | | tmux_pane_current_command | Get current command in pane | | tmux_session_info | NEW Get detailed session information |

| Tool | Description | |:-----|:------------| | log_sources | List all log sources | | log_get_recent | Get recent log entries | | log_search | Search logs for a pattern | | log_get_errors | Get error-level logs | | log_get_warnings | Get warning-level logs | | log_tail | Tail a specific log file | | log_stats | NEW Log file statistics and analysis |

| Tool | Description | |:-----|:------------| | resource_cpu | Get CPU usage | | resource_memory | Get memory usage | | resource_disk | Get disk usage | | resource_load | Get system load average | | resource_overview | Get comprehensive resource overview | | resource_processes | Get process list sorted by resource | | resource_uptime | Get system uptime | | resource_network_stats | Get network statistics | | resource_battery | NEW Battery status and health | | resource_temperature | NEW CPU/GPU temperature monitoring |

| Tool | Description | |:-----|:------------| | network_interfaces | List network interfaces | | network_connections | List active connections | | network_listening_ports | List listening ports | | network_stats | Get network statistics | | network_gateway | Get default gateway | | network_ping | Ping a host (with validation) | | network_bandwidth | Get bandwidth usage | | network_overview | Get network overview | | network_dns_lookup | DNS lookup with IPv4/IPv6 | | network_port_check | Check if port is open on host | | network_public_ip | Get public IP address | | network_wifi_info | WiFi connection details | | network_route_table | NEW Show routing table | | network_ssl_check | NEW Check SSL certificate for a host | | network_traceroute | NEW Traceroute to a host |

| Tool | Description | |:-----|:------------| | process_info | Get process details by PID | | process_list | List all processes | | process_search | Search processes by name | | process_tree | Get process tree | | process_file_descriptors | Get file descriptors for process | | process_environment | Get environment variables for process | | process_children | Get child processes | | process_top | Get top processes by CPU/memory | | process_kill | Kill process with safety confirmation | | process_ports | Processes with network ports | | process_cpu_history | CPU usage history | | process_memory_detail | Detailed memory breakdown | | process_threads | NEW List threads for a process | | process_io_stats | NEW I/O statistics for a process (Linux) |

| Tool | Description | |:-----|:------------| | file_stats | Get file/directory stats | | file_recent_changes | Get recently changed files | | file_search | Search files by glob pattern | | file_tree | Get directory tree | | file_compare | Compare two files | | file_changes_since | Get files changed since timestamp | | file_read | Safe file reading with size limits | | file_checksum | NEW MD5/SHA256 file checksums | | file_size_summary | NEW Directory size analysis | | file_duplicates | NEW Find duplicate files |

| Tool | Description | |:-----|:------------| | claude_config | Get Claude Desktop configuration | | claude_mcp_status | Get MCP server status | | claude_session_info | Get Claude session info | | claude_logs | Get Claude logs | | claude_log_search | Search Claude logs | | claude_log_files | List Claude log files | | claude_background_shells | Get background shell info | | claude_status | Get comprehensive Claude status |

| Tool | Description | |:-----|:------------| | github_list_issues | List GitHub issues | | github_get_issue | Get issue details | | github_create_issue | Create new issue | | github_update_issue | Update issue | | github_add_comment | Add comment to issue/PR | | github_list_prs | List pull requests | | github_get_pr | Get PR details | | github_create_pr | Create pull request | | github_merge_pr | Merge pull request | | github_list_labels | List repository labels | | github_add_labels | Add labels to issue/PR | | github_list_milestones | List milestones | | github_list_workflows | List GitHub Actions workflows | | github_list_workflow_runs | List recent workflow runs | | github_repo_info | Repository metadata and stats | | github_list_releases | Release history | | github_list_branches | Branch listing with protection | | github_compare_commits | Compare commits/branches | | github_list_pr_reviews | NEW List reviews for a pull request | | github_create_review | NEW Create a review for a pull request | | github_submit_review | NEW Submit a pending review |

| Tool | Description | |:-----|:------------| | health_check | Comprehensive system health validation |

Validates: Git connectivity, GitHub API status, system resources, and overall health.

| Tool | Description | |:-----|:------------| | linux_systemd_units | NEW List systemd units (Linux only) | | linux_systemd_status | NEW Get status of a systemd unit | | linux_journal_search | NEW Search systemd journal |

| Tool | Description | |:-----|:------------| | windows_service_status | NEW Get Windows service status | | windows_eventlog_search | NEW Search Windows Event Log |

| Tool | Description | |:-----|:------------| | docker_ps | NEW List Docker containers (running/all) | | docker_images | NEW List Docker images | | docker_logs | NEW Get container logs with tail/since options | | docker_inspect | NEW Get container or image details | | docker_stats | NEW Get container resource usage (CPU/Memory) | | docker_exec | NEW Execute command in container | | docker_start | NEW Start a stopped container | | docker_stop | NEW Stop a running container | | docker_restart | NEW Restart a container | | docker_build | NEW Build Docker image from Dockerfile |

| Tool | Description | |:-----|:------------| | compose_ps | NEW List Compose services status | | compose_up | NEW Start Compose services (detach, build options) | | compose_down | NEW Stop Compose services (volumes, orphans options) | | compose_logs | NEW Get Compose service logs |

| Tool | Description | |:-----|:------------| | k8s_get_pods | NEW List Kubernetes pods | | k8s_get_deployments | NEW List Kubernetes deployments | | k8s_logs | NEW Get pod logs | | k8s_describe | NEW Describe Kubernetes resource | | k8s_apply | NEW Apply Kubernetes manifest (dry-run supported) | | k8s_delete | NEW Delete Kubernetes resource (dry-run supported) |

| Tool | Description | |:-----|:------------| | speckit_init | NEW Initialize Spec-Kit in project (creates .speckit/ directory) | | speckit_status | NEW Get Spec-Kit project status | | speckit_constitution | NEW Read or update project constitution (principles) | | speckit_specify | NEW Create feature specification from description | | speckit_plan | NEW Generate implementation plan for a feature | | speckit_tasks | NEW Generate task list from plan | | speckit_checklist | NEW Create implementation checklist | | speckit_analyze | NEW Analyze project for consistency | | speckit_list_features | NEW List all features in project |

| Tool | Description | |:-----|:------------| | mcp_search_tools | NEW Search MCP tools by name or description | | mcp_list_categories | NEW List all tool categories with counts | | mcp_get_tool_info | NEW Get detailed information about a specific tool |

| Tool | Description | |:-----|:------------| | db_connect | NEW Test database connection (SQLite/PostgreSQL/MySQL) | | db_tables | NEW List all tables in database | | db_schema | NEW Get schema for a specific table | | db_query | NEW Execute read-only SQL query (SELECT only) | | db_explain | NEW Explain query execution plan | | db_health | NEW Check database health and statistics |

Supported Databases:

• SQLite: File-based, zero configuration
• PostgreSQL: Full-featured relational database
• MySQL: Popular open-source database

Security: All queries are SELECT-only. Dangerous patterns (DROP, DELETE, etc.) are blocked.

| Tool | Description | |:-----|:------------| | time_current | NEW Get current time in specified timezone | | time_convert | NEW Convert time between timezones | | time_format | NEW Format datetime with custom pattern | | time_diff | NEW Calculate difference between two times |

| Tool | Description | |:-----|:------------| | calc_expression | NEW Evaluate mathematical expression safely | | calc_unit_convert | NEW Convert between units (length, weight, temp, etc.) | | calc_statistics | NEW Calculate statistics (mean, median, stddev, etc.) |

| Tool | Description | |:-----|:------------| | think_step | NEW Record a thinking step in sequential reasoning | | think_branch | NEW Create alternative thinking branch | | think_summarize | NEW Summarize a thinking session |

| Tool | Description | |:-----|:------------| | gen_uuid | NEW Generate UUID (v1 or v4) | | gen_random | NEW Generate random numbers | | gen_hash | NEW Generate hash (MD5, SHA256, etc.) | | gen_password | NEW Generate secure password with entropy |

🔒 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

| Feature | Protection | |:--------|:-----------| | Command Injection | All shell arguments sanitized | | Path Traversal | Base path validation on all file operations | | DNS Rebinding | Hostname validation for network tools | | Process Safety | PID validation and confirmation for kill operations | | File Size Limits | Prevents memory exhaustion attacks |

✅ 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

Included Claude Code Plugins (v2.0.0)

This package includes the complete Miyabi plugin ecosystem:

| Agent | Description | |:------|:------------| | coordinator-agent | Multi-agent orchestration and task distribution | | codegen-agent | AI-driven code generation (Rust, TypeScript, Python) | | pr-agent | Pull request creation and management | | review-agent | Code review automation | | issue-agent | GitHub issue analysis and triage | | deployment-agent | CI/CD and deployment automation | | analytics-agent | Data analysis and visualization | | honoka-agent | Udemy course creation specialist | | marketing-agent | Marketing strategy and content | | crm-agent | Customer relationship management | | jonathan-ive-design-agent | UI/UX design with Apple design principles | | lp-gen-agent | Landing page generation | | narration-agent | Voice narration and script writing | | ... and 25 more agents |

| Skill | Description | |:------|:------------| | rust-development | Rust build, test, clippy, fmt workflow | | git-workflow | Conventional commits and PR workflow | | tdd-workflow | Test-driven development patterns | | security-audit | Security scanning and vulnerability checks | | performance-analysis | Profiling and optimization | | debugging-troubleshooting | Error diagnosis and resolution | | documentation-generation | Auto-generate docs from code | | project-setup | New project scaffolding | | dependency-management | Package updates and auditing | | context-eng | Context window optimization | | issue-analysis | Issue triage and prioritization | | voicevox | Japanese voice synthesis | | tmux-iterm-integration | Terminal session management | | paper2agent | Research paper to agent conversion | | business-strategy-planning | Business analysis workflows | | sales-crm-management | Sales pipeline automation | | market-research-analysis | Competitive analysis | | content-marketing-strategy | Content planning | | growth-analytics-dashboard | Growth metrics tracking | | agent-execution | Agent spawning and management | | claude-code-x | Extended Claude Code workflows |

| Command | Description | |:--------|:------------| | /deploy | Execute deployment pipeline | | /pr-create | Create pull request | | /issue-create | Create GitHub issue | | /health-check | System health verification | | /security-scan | Run security audit | | /dashboard | Show project dashboard | | /worktree-create | Create git worktree | | /tmux-orchestra-start | Start tmux orchestration | | /codex | OpenAI Codex integration | | /voicevox | Voice synthesis | | /generate-docs | Generate documentation | | /test-escalation | Run test escalation | | ... and 44 more commands |

| Hook | Description | |:-----|:------------| | agent-complete.sh | Post-agent execution | | agent-worktree-pre.sh | Before worktree creation | | agent-worktree-post.sh | After worktree creation | | auto-format.sh | Auto-format on save | | validate-rust.sh | Rust validation pre-commit | | validate-typescript.sh | TypeScript validation | | git-ops-validator.sh | Git operation validation | | codex-monitor.sh | Codex process monitoring | | session-keepalive.sh | Session persistence | | notification.sh | Desktop notifications | | ... and 14 more hooks |

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一覧を表示して」

🛠️ ツールカテゴリ

| カテゴリ | ツール数 | 説明 | |:---------|:--------:|:-----| | 🔀 Git Inspector | 19 | Git状態、ブランチ、差分、履歴、タグ、貢献者、コンフリクト | | 📺 Tmux Monitor | 10 | セッション、ウィンドウ、ペイン管理 | | 📋 Log Aggregator | 7 | ログ検索、エラー、警告、統計 | | 💻 Resource Monitor | 10 | CPU、メモリ、ディスク、バッテリー、温度 | | 🌐 Network Inspector | 15 | インターフェース、接続、ポート、DNS、SSL証明書、traceroute | | ⚙️ Process Inspector | 14 | プロセス一覧、ツリー、詳細、スレッド、I/O | | 📁 File Watcher | 10 | ファイル変更、検索、比較、チェックサム | | 🤖 Claude Monitor | 8 | Claude Desktop設定、ログ、MCP状態 | | 🐙 GitHub Integration | 21 | Issue、PR、レビュー、ラベル、リリース | | 🏥 Health Check | 1 | システムヘルス検証 | | 🐧 Linux systemd | 3 | systemdユニット、ジャーナル | | 🪟 Windows | 2 | サービス状態、イベントログ | | 🐳 Docker | 10 | コンテナ一覧、ログ、stats、起動/停止、ビルド | | 📦 Docker Compose | 4 | サービス起動/停止、ログ、状態 | | ☸️ Kubernetes | 6 | Pod、Deployment、ログ、describe、apply/delete | | 📋 Spec-Kit | 9 | Spec-Driven Development（spec作成、検証） | | 🔎 MCP Tool Discovery | 3 | ツール検索、カテゴリ一覧 | | 🗄️ Database Foundation | 6 | SQLite/PostgreSQL/MySQL 基本操作 | | ⏰ Time Tools | 4 | タイムゾーン、フォーマット、差分 | | 🧮 Calculator Tools | 3 | 数式、単位変換、統計 | | 🧠 Sequential Thinking | 3 | 思考ステップ、分岐、要約 | | 🎲 Generator Tools | 4 | UUID、乱数、ハッシュ、パスワード |

⭐ このプロジェクトが役立ったら、スターをお願いします！

あなたのスターが、他の開発者がこのツールを発見する手助けになります。

🌟 Star History

🤝 コントリビューション歓迎！

PRやIssueでのフィードバックをお待ちしています。

Made with ❤️ by Shunsuke Hayashi

🚀 172 Tools | 🔐 Enterprise Security | ⚡ Zero Config | 🌍 Cross-Platform