<div align="center">

🌸 Miyabi MCP Bundle

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

<br />

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

<br />

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

<br />

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

<br />

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

</div>

---

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

<table> <tr> <td width="50%">

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

</td> <td width="50%">

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

</td> </tr> </table>

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

<details> <summary><b>📍 Config File Locations</b></summary>

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

</details>

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

<details> <summary><b>🔧 Environment Variables</b></summary>

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

</details>

---

🚀 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

<div align="center">

172 Tools Across 21 Categories + Health Check

</div>

<details open> <summary><h3>🔀 Git Inspector <code>19 tools</code></h3></summary>

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

</details>

<details> <summary><h3>📺 Tmux Monitor <code>10 tools</code></h3></summary>

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

</details>

<details> <summary><h3>📋 Log Aggregator <code>7 tools</code></h3></summary>

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

</details>

<details> <summary><h3>💻 Resource Monitor <code>10 tools</code></h3></summary>

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

</details>

<details> <summary><h3>🌐 Network Inspector <code>15 tools</code></h3></summary>

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

</details>

<details> <summary><h3>⚙️ Process Inspector <code>14 tools</code></h3></summary>

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)

</details>

<details> <summary><h3>📁 File Watcher <code>10 tools</code></h3></summary>

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

</details>

<details> <summary><h3>🤖 Claude Monitor <code>8 tools</code></h3></summary>

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

</details>

<details> <summary><h3>🐙 GitHub Integration <code>21 tools</code></h3></summary>

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

</details>

<details> <summary><h3>🏥 Health Check <code>1 tool</code></h3></summary>

Tool	Description
health_check	Comprehensive system health validation

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

</details>

<details> <summary><h3>🐧 Linux systemd <code>3 tools</code></h3></summary>

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

</details>

<details> <summary><h3>🪟 Windows <code>2 tools</code></h3></summary>

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

</details>

<details> <summary><h3>🐳 Docker <code>10 tools</code></h3></summary>

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

</details>

<details> <summary><h3>📦 Docker Compose <code>4 tools</code></h3></summary>

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

</details>

<details> <summary><h3>☸️ Kubernetes <code>6 tools</code></h3></summary>

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)

</details>

<details> <summary><h3>📋 Spec-Kit <code>9 tools</code> - Spec-Driven Development</h3></summary>

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

</details>

<details> <summary><h3>🔍 MCP Tool Discovery <code>3 tools</code></h3></summary>

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

</details>

<details> <summary><h3>🗄️ Database Foundation <code>6 tools</code></h3></summary>

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.

</details>

<details> <summary><h3>⏰ Time Tools <code>4 tools</code></h3></summary>

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

</details>

<details> <summary><h3>🔢 Calculator Tools <code>3 tools</code></h3></summary>

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

</details>

<details> <summary><h3>🧠 Sequential Thinking <code>3 tools</code></h3></summary>

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

</details>

<details> <summary><h3>🎲 Generator Tools <code>4 tools</code></h3></summary>

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

</details>

---

🔒 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

<div align="center">

Included Claude Code Plugins (v2.0.0)

</div>

This package includes the complete Miyabi plugin ecosystem:

<details open> <summary><h3>🤖 38 AI Agents</h3></summary>

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

</details>

<details> <summary><h3>🎯 22 Development Skills</h3></summary>

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

</details>

<details> <summary><h3>📋 56 Slash Commands</h3></summary>

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

</details>

<details> <summary><h3>🪝 24 Hooks</h3></summary>

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

</details>

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

---

<div align="center">

🇯🇵 日本語

</div>

✨ 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、乱数、ハッシュ、パスワード

---

<div align="center">

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

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

<br />

🌟 Star History

<br />

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

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

<br />

Made with ❤️ by Shunsuke Hayashi

<br />

<br />

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

</div>