Mastercard Developers MCP

Mastercard Developers MCP 服务

一个模型上下文协议（MCP）服务，可访问 Mastercard Developers 文档。

概述

此 MCP 服务充当 MCP 客户端与 Mastercard Developers 资源之间的桥梁，提供以下工具：

• 列出可用的 Mastercard 服务
• 查询 API 规范及其操作
• 访问各项服务的文档
• 获取 OAuth 1.0a、OAuth 2.0 和 Open Finance 集成指南

可用工具

服务发现

• get-services-list：列出所有可用的 Mastercard Developers 产品和服务及其基本信息，包括标题、描述和服务 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：获取全面的 OAuth 1.0a 集成指南，包括 Mastercard API 的分步说明、代码示例和最佳实践。

• get-oauth20-integration-guide：获取全面的 OAuth 2.0 集成指南，包括 Mastercard API 的分步说明、代码示例和最佳实践。

• get-openfinance-integration-guide：获取全面的 Open Finance 集成指南，包括设置说明、API 使用示例和实施最佳实践。

配置选项

你可以通过传入特定服务或 API 规范作为参数，预先配置此服务。 当你使用特定服务并希望让 Agent 专注于该服务时，这会很有用

• 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 文件

运行以下命令，即可构建 DXT 文件，以便一键安装 Claude Desktop：

npm run build-dxt

调试服务

npx @modelcontextprotocol/inspector node dist/index.js

参考资料

• Mastercard Developers Platform
• Model Context Protocol
• MCP SDKs