@mockzilla/mcp

mockzilla用MCPサーバー。Claude DesktopやCursorのようなエージェントが、ユーザーに代わってmockzillaを操作できるようにします。また、アカウントを作成する前にユーザーがmockzillaを試す手助けもします。

このブリッジは2つのツールプレーンを公開しています：

• ローカルプレーン（アカウント不要）： Mockzilla CLIがインストールされているか確認し、ユーザーのためにインストール（ビルド済みバイナリ、go install、またはgo run）し、OpenAPI仕様書をプレビューし、ポータブルなモックサーバーをローカルで実行します。ユーザーのPCからデータが外部に出ることはありません。

• ホストプレーン（アカウント必要）： MOCKZILLA_TOKENが設定されている場合、mockzilla.orgのMCPエンドポイントにプロキシされます。シミュレーションの一覧表示や、カタログからのバンドルデプロイなどが可能です。

トークンがない場合、ローカルプレーンのみが利用可能です。エージェントは、ユーザーがサインアップする前にmockzillaを探索する手助けをすることができます。

インストール

Claude Code

ワンライナー、設定ファイルの編集不要：

claude mcp add -s user mockzilla -- npx -y @mockzilla/mcp@latest

-s userはユーザーアカウント用にインストールします（すべてのプロジェクトで利用可能）。-s userを外すと、現在のプロジェクトのみにスコープされます。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.jsonを編集します：

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"]
    }
  }
}

Cursor

最も簡単な方法：Cursor設定 → MCPサーバー → 新しいMCPサーバーを追加、以下を入力：

• 名前: mockzilla

• コマンド: npx

• 引数: -y @mockzilla/mcp@latest

または~/.cursor/mcp.jsonを直接編集：

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"]
    }
  }
}

Gemini CLI

ワンライナー、設定ファイルの編集不要：

gemini mcp add -s user mockzilla npx -y @mockzilla/mcp@latest

-s userは~/.gemini/settings.jsonに書き込みます（すべてのプロジェクトで利用可能）。-s userを外す（または-s projectを使用する）と、現在のディレクトリの.gemini/settings.jsonにスコープされます。

または設定ファイルを直接編集：

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"]
    }
  }
}

設定を編集した後はクライアントを再起動してください。

なぜ@latestなのか？ これがないと、npxは最初に解決されたバージョンをキャッシュし、新しく公開されたバージョンを取得しません。@latestに固定することで、npxは起動のたびにレジストリを再確認するため、Claude DesktopやCursorを再起動するだけでアップグレードできます。トレードオフ：起動時に約200msの追加時間がかかります。

何ができるか

トークンなし（ローカルプレーン）：

• 「Mockzilla CLIはインストールされていますか？」

• 「Mockzillaをインストールして。」（エージェントがダウンロード / go-install / go-runのいずれかを確認します）

• 「petstoreの仕様書をローカルで立ち上げて、curlできるようにして。」

• 「https://example.com/openapi.yaml にはどんなエンドポイントがありますか？」

• 「起動したモックを停止して。」

トークンあり（ホストプレーンが追加）：

• 「デプロイ済みのシミュレーションを一覧表示して。」

• 「カタログ製品を見せて。」

• 「stripe-testという名前のStripeサンドボックスをデプロイして、ライブURLを待機して。」

• 「このOpenAPI URLからMockzilla上にモックを作成して。」

ツール

ローカル

ホスト

MOCKZILLA_TOKENが設定されている場合に利用可能。mockzilla.orgに転送されます。ライブツールリストについてはホストサーバーのドキュメントを参照してください。執筆時点ではget_context、list_sims、list_catalog_products、deploy_mock_from_{catalog,spec,url}、wait_for_deployが含まれます。

設定

キャッシュ

ブリッジはすべてを~/.cache/mockzilla-mcp/以下に保持します：

~/.cache/mockzilla-mcp/
├── bin/mockzilla        # downloaded or go-installed binary
├── config.json          # {method, version, invocation?}
└── mocks/               # mock_endpoint persists static endpoints here
    └── static/
        └── <service>/<path>/<method>/index.<ext>

rm -rf ~/.cache/mockzilla-mcpでブリッジを完全にリセットします（バイナリ + すべてのモックエンドポイント）。モックのみを削除する場合：rm -rf ~/.cache/mockzilla-mcp/mocks。システムPATHには一切触れないため、リセットしても個別のbrewインストールには影響しません。

アップデート

ブリッジは頻繁に更新されます。最新の状態を保つための推奨方法：

1. MCPクライアント設定で@mockzilla/mcp@latestを固定し（上記のインストールスニペットを参照）、npxが起動のたびにレジストリを再確認するようにします。

2. Claude Desktop / Cursorを定期的に再起動します。そのタイミングで新しいバージョンが取得されます。

3. 何か問題が発生した場合は、エージェントに「bridge_statusを実行して、mockzilla-mcpが最新かどうか教えて」と尋ねてください。古い場合は、npx clear-npx-cache @mockzilla/mcpを実行してクライアントを再起動してください。

Mockzilla CLIのバージョンはブリッジによって固定されています（lib/install.js内のMOCKZILLA_VERSION）。ブリッジを更新すると固定バージョンも更新され、次のinstall_cli呼び出しでCLI自体が最新になります。

開発

プロジェクトの規約と新しいツールの追加手順についてはCLAUDE.mdを参照してください。

ライセンス

MIT。