コンテンツにスキップ
Zenn Dev Kou Pg 0131 Articles Mmcp Introduction

複数 AI エージェントの MCP サーバーの設定を一元管理する「mmcp」の紹介

  • URL: https://zenn.dev/kou_pg_0131/articles/mmcp-introduction
  • 日付: 2026-06-26
  • Tier: Tier 3
  • 要旨: Claude Code、Codex CLI、Gemini CLI、Cursor など複数の AI エージェントが個別に持つ MCP サーバー設定を ~/.mmcp.json で一元管理するツール mmcp が公開された。mmcp add でサーバーを追加し mmcp apply を実行するだけで、各エージェントのフォーマット(JSON や TOML)の差異を吸収して設定を配布できる。TOML 形式の Codex CLI への適用には @shopify/toml-patch を使いコメントを保持しながら更新する工夫が施されている。v0.3.1 時点で Claude Code、Claude Desktop、Codex CLI、Cursor、Gemini CLI の 5 エージェントに対応している。

詳細

インストール: npm install -g mmcp

主なコマンド:

  • mmcp add -- <name> <command> [args...] — MCP サーバーを追加(--env KEY=VALUE で環境変数指定も可)
  • mmcp list — 登録済み MCP サーバーを一覧表示
  • mmcp agents add <name...> — 適用対象エージェントを追加
  • mmcp agents list — 登録済みエージェントを一覧表示
  • mmcp apply — 全エージェントの設定ファイルに MCP 設定をマージ

設定ファイルは ~/.mmcp.json に保存され直接編集も可能

対応エージェントと設定ファイルパス(v0.3.1):

  • Claude Code: ~/.claude.json
  • Claude Desktop: macOS ~/Library/Application Support/Claude/claude_desktop_config.json、Windows %APPDATA%\Claude\...
  • Codex CLI: ~/.codex/config.toml(TOML 形式。@shopify/toml-patch でコメント保持しながら更新)
  • Cursor: ~/.cursor/mcp.json
  • Gemini CLI: ~/.gemini/settings.json

仕組み: .mmcp.json の内容を各エージェントの設定ファイルの MCP サーバー設定部分にマージするだけ。作者は実装の約 8 割を Codex CLI に委譲したと述べている。