Mcpclientmock

🚀 mockserver-mcp

MockServer（James Bloom's MockServer）とやり取りするためのMCP（Model Context Protocol）サーバーです。これにより、AIアシスタントはプログラムでモックHTTPエクスペクテーションの作成、リクエストの検証、状態のクリア、MockServerインスタンスの管理を行うことができます。

🚀 クイックスタート

MockServerを使用してモックHTTPエクスペクテーションを作成し、リクエストを検証するために、このmockserver-mcpを使いましょう。

✨ 主な機能

• AIアシスタントがMockServerとやり取りできるようにする。
• モックHTTPエクスペクテーションの作成、リクエストの検証、状態のクリア、MockServerインスタンスの管理が可能。

📦 インストール

前提条件

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

# Dockerを使用する場合（最も簡単）
docker run -d -p 1080:1080 mockserver/mockserver

インストール方法

npxを使用する（推奨）

npx mockserver-mcp

グローバルインストール

npm install -g mockserver-mcp
mockserver-mcp

📚 ドキュメント

設定

環境変数

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