Mastercard Developers MCP

Mastercard Developers MCP サーバー

Mastercard Developers のドキュメントにアクセスするための Model Context Protocol（MCP）サーバーです。

概要

この MCP サーバーは、MCP クライアントと Mastercard Developers のリソースをつなぐブリッジとして機能し、次のツールを提供します。

• 利用可能な Mastercard サービスの一覧表示
• API 仕様と各操作の照会
• 各サービスのドキュメントへのアクセス
• OAuth 1.0a、OAuth 2.0、Open Finance のインテグレーションガイドの取得

利用可能なツール

サービスの検索

• get-services-list：利用可能なすべての Mastercard Products and Services の基本情報（タイトル、説明、サービス ID など）を一覧表示します。

ドキュメント

• get-documentation：特定の Mastercard サービスで利用可能なすべてのドキュメントの概要（セクションのタイトル、説明、ナビゲーションリンクなど）を提供します。

• get-documentation-section-content：特定のドキュメントセクションの全コンテンツを取得します。

• get-documentation-page：特定のドキュメントページの全コンテンツを取得します。

API 操作

• get-api-operation-list：特定の Mastercard API 仕様に含まれるすべての API 操作の概要（HTTP メソッド、リクエストパス、タイトル、説明など）を提供します。

• get-api-operation-details：特定の API 操作に関する詳細情報（パラメーターの定義、リクエストとレスポンスのスキーマ、API 呼び出しを成功させるための技術仕様など）を提供します。

インテグレーションガイド

• get-oauth10a-integration-guide：Mastercard API 向けの OAuth 1.0a インテグレーションガイド一式（手順、コード例、ベストプラクティスなど）を取得します。

• get-oauth20-integration-guide：Mastercard API 向けの OAuth 2.0 インテグレーションガイド一式（手順、コード例、ベストプラクティスなど）を取得します。

• get-openfinance-integration-guide：Open Finance のインテグレーションガイド一式（セットアップ手順、API の使用例、実装のベストプラクティスなど）を取得します。

設定オプション

引数として渡すことで、特定のサービスまたは API 仕様をサーバーに事前設定できます。 特定のサービスを扱う際に、エージェントの対象を絞り込みたい場合に便利です。

• service：MCP の対象にしたいサービスのドキュメントの URL。例：https://developer.mastercard.com/mdes-customer-service/documentation
• api-specification：MCP ツールの対象にしたい API 仕様の URL。例：https://static.developer.mastercard.com/content/match/swagger/match-pro.yaml。サービスの API Reference ページにある Download Spec ボタンからリンクを取得できます。 注：この項目を指定すると、service 設定で指定した値は上書きされます。

service または api-specification を指定すると、get-services-list ツールは無効になります。

MCP クライアントとの統合

Claude Desktop などの MCP クライアントでこのサーバーを使用するには、MCP 設定に追加してください。

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

特定のサービスの場合

{
  "mcpServers": {
    "mastercard-developers": {
      "command": "npx",
      "args": [
        "-y",
        "@mastercard/developers-mcp",
        "--service=https://developer.mastercard.com/open-finance-us/documentation/"
      ]
    }
  }
}

特定の API 仕様の場合

{
  "mcpServers": {
    "mastercard-developers": {
      "command": "npx",
      "args": [
        "-y",
        "@mastercard/developers-mcp",
        "--api-specification=https://developer.mastercard.com/open-finance-us/swagger/openbanking-us.yaml"
      ]
    }
  }
}

VSCode での使用方法

すばやくインストールするには、以下のワンクリックインストールボタンのいずれかを使用してください。

手動でインストールするには、以下の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加してください。Ctrl + Shift + P を押して「Preferences: Open Settings (JSON)」と入力すると追加できます。

必要に応じて、ワークスペース内の .vscode/mcp.json というファイルに追加することもできます。これにより、設定を他のユーザーと共有できます。

.vscode/mcp.json ファイルでは mcp キーは不要です。

NPX

{
  "mcp": {
    "servers": {
      "mastercard-developers": {
        "command": "npx",
        "args": ["-y", "@mastercard/developers-mcp"]
      }
    }
  }
}

上記の例のように、設定オプションを引数として指定することもできます。

開発

前提条件：Node.js 18+

1. 依存関係をインストールします。

   npm install
   

2. プロジェクトをビルドします。

   npm run build
   

3. テストを実行します。

   npm run test
   

4. サーバーを起動します。

    npm run start
   

開発中に変更を監視します。

npm run watch

サーバーは stdio で実行され、MCP クライアントから接続できます。

設定オプションを指定する場合

# Pre-configure with a documentation URL
npm run start -- --service=https://developer.mastercard.com/open-finance-us/documentation/

# Pre-configure with an API specification path
npm run start -- --api-specification=https://static.developer.mastercard.com/content/open-finance-us/swagger/openbanking-us.yaml

DXT ファイルをビルドする

以下を実行すると、Claude Desktop にワンクリックでインストールするための DXT ファイルをビルドできます。

npm run build-dxt

サーバーのデバッグ

npx @modelcontextprotocol/inspector node dist/index.js

参考資料

• Mastercard 開発者プラットフォーム
• Model Context Protocol
• MCP SDK