项目简介

Mastercard开发者智能代理工具包是一个基于Model Context Protocol (MCP) 的服务器实现，旨在帮助LLM（大型语言模型）代理程序更便捷地集成Mastercard开发者平台。它通过标准化协议提供服务发现、详细文档检索以及API操作的访问能力，极大地简化了与Mastercard服务的集成流程，使LLM能够智能地与Mastercard生态系统互动。

主要功能点

服务发现: 允许LLM代理程序自动发现Mastercard开发者平台上所有可用的产品和服务，包括其标题、描述和唯一的服务ID。
文档访问: 提供对特定Mastercard服务详细文档的访问能力，包括获取文档概述、特定章节内容，以及检索OAuth 1.0a和Open Finance等重要集成指南。
API操作: 能够获取特定API规范的所有操作摘要（包括HTTP方法、请求路径、标题和描述），并查询特定API操作的详细信息（如参数定义、请求和响应Schema）。
灵活部署: 该工具包既可以作为独立的MCP服务器运行，也可以作为TypeScript/JavaScript项目中的库进行集成，以适应不同的应用场景。

安装步骤

环境要求: 确保您的系统已安装Node.js 18或更高版本。

安装工具包: 在您的项目中，通过npm安装此工具包：

npm install --save @mastercard/developers-agent-toolkit

运行独立MCP服务器: 要将此工具包作为独立的MCP服务器运行，您可以使用'npx'命令：
```
npx -y @mastercard/developers-mcp
```

服务器配置

MCP客户端需要以下配置信息来连接并使用Mastercard开发者MCP服务器。这些信息将指导MCP客户端如何启动和与服务器通信。

{
  "name": "mastercard-developers-mcp",
  "command": "npx",
  "args": [
    "-y",
    "@mastercard/developers-mcp",
    "--service=<可选的服务URL>",
    "--api-specification=<可选的API规范URL>"
  ],
  "description": "连接到Mastercard开发者平台的MCP服务器，提供服务发现、文档和API操作工具。",
  "notes": "  --service: 可选参数。用于指定一个特定的Mastercard服务URL，例如 'https://developer.mastercard.com/send/documentation/'。设置此参数后，服务器将针对该服务提供上下文，并自动禁用获取所有服务列表的工具。\n  --api-specification: 可选参数。用于指定一个Mastercard API规范文件URL，例如 'https://static.developer.mastercard.com/content/open-finance-us/swagger/openbanking-us.yaml'。设置此参数后，服务器将针对该API规范提供上下文。"
}

基本使用方法

一旦Mastercard开发者MCP服务器启动并运行，您的MCP客户端或LLM代理框架即可通过JSON-RPC协议与其进行通信和调用。MCP客户端可以发送请求来调用服务器注册的各种工具函数。

例如：

如果LLM代理需要了解Mastercard平台提供的所有服务，它可以请求调用'get-services-list'工具。
如果LLM代理需要查询特定服务的文档，例如“Open Finance”服务的文档概述，它可以调用'get-documentation'工具并提供相应的'serviceId'参数。
若要获取特定API的详细操作信息，LLM代理可以调用'get-api-operation-details'工具，提供API规范路径、HTTP方法和端点路径。

MCP服务器会处理这些请求，执行底层逻辑（例如调用Mastercard的API或获取文档内容），然后将结果以标准化的JSON-RPC响应格式返回给客户端。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息