MCPClientMock

mockserver-mcp

James Bloom's MockServer と連携するための MCP（Model Context Protocol）サーバーです。AI アシスタントを使って、HTTP のモック期待値の作成、リクエストの検証、状態のクリア、MockServer インスタンスのプログラムによる管理ができます。

前提条件

実行中の MockServer インスタンスが必要です。

# Using Docker (easiest)
docker run -d -p 1080:1080 mockserver/mockserver

インストール

npx を使用する（推奨）

npx mockserver-mcp

グローバルインストール

npm install -g mockserver-mcp
mockserver-mcp

設定

環境変数

変数	説明	デフォルト
MOCKSERVER_HOST	MockServer のホスト名	localhost
MOCKSERVER_PORT	MockServer のポート	1080

MCP クライアントの設定

MCP クライアントの設定ファイル（例：Claude Desktop、Kiro、Cursor）に追加します。

{
  "mcpServers": {
    "mockserver": {
      "command": "npx",
      "args": ["-y", "mockserver-mcp"],
      "env": {
        "MOCKSERVER_HOST": "localhost",
        "MOCKSERVER_PORT": "1080"
      }
    }
  }
}

チームで共有する MockServer の場合は、MOCKSERVER_HOST をサーバーのアドレスに変更してください。

利用可能なツール

mockserver_create_expectation

MockServer に HTTP のモック期待値を作成します。

パラメーター：

• httpRequest（必須）：リクエストの照合条件
  • method：HTTP メソッド（GET、POST、PUT、DELETE など）
  • path：照合する URL パス
  • queryStringParameters：照合するクエリパラメーター
  • headers：照合するヘッダー
  • body：type（STRING、JSON、REGEX、XPATH、JSON_PATH）と value を指定するボディマッチャー
• httpResponse：レスポンスの設定
  • statusCode：HTTP ステータスコード
  • headers：レスポンスヘッダー
  • body：レスポンスボディ（文字列またはオブジェクト）
  • delay：timeUnit と value を指定するレスポンスの遅延
• times：照合する回数（remainingTimes、unlimited）
• timeToLive：期待値の有効期間（timeUnit、timeToLive）

例：

{
  "httpRequest": {
    "method": "GET",
    "path": "/api/users"
  },
  "httpResponse": {
    "statusCode": 200,
    "body": { "users": [] }
  }
}

mockserver_verify

条件に一致するリクエストを MockServer が受信したことを検証します。

パラメーター：

• httpRequest（必須）：リクエストの照合条件（create_expectation と同じ）
• times：予期されるリクエスト数
  • atLeast：リクエストの最小数
  • atMost：リクエストの最大数
  • exactly：リクエストの正確な数

例：

{
  "httpRequest": {
    "method": "POST",
    "path": "/api/orders"
  },
  "times": {
    "atLeast": 1
  }
}

mockserver_clear

MockServer から期待値と記録済みリクエストをクリアします。

パラメーター：

• httpRequest（任意）：特定の期待値をクリアするリクエストマッチャーです。指定しない場合はすべてクリアします。

例：

{
  "httpRequest": {
    "path": "/api/users"
  }
}

mockserver_reset

すべての期待値と記録済みリクエストをクリアし、MockServer を完全にリセットします。

パラメーター： なし

mockserver_retrieve_requests

MockServer から記録済みリクエストを取得します。

パラメーター：

• httpRequest（任意）：記録済みリクエストを絞り込むリクエストマッチャー

例：

{
  "httpRequest": {
    "method": "GET"
  }
}

mockserver_status

MockServer の接続状態と設定を取得します。

パラメーター： なし

モックを使う理由

API のモックを使えば、早い段階からテストできます。バックエンドの準備が整う前に、フロントエンドや連携機能の構築とテストを始められます。もう待つ必要はありません。より早くリリースできます。

要件

• Node.js >= 18.0.0
• 実行中の MockServer インスタンス

リンク

• npm：https://www.npmjs.com/package/mockserver-mcp
• GitHub：https://github.com/Akkshay10/MCPClientMock
• MCP Registry：https://registry.modelcontextprotocol.io

ライセンス

MIT