Extend MCP Server 使用说明

项目简介

Extend AI Toolkit MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为LLM客户端（如 Claude Desktop）提供访问 Extend API 功能的标准化接口，主要用于费用管理和虚拟卡操作。通过此服务器，LLM客户端可以安全、可扩展地获取上下文信息和调用Extend API的功能。

主要功能点

资源访问: 允许LLM客户端访问和查询 Extend API 中的虚拟卡、信用卡、交易记录和费用类别等资源。
工具调用: 提供一系列预定义的工具，例如获取虚拟卡列表、查询交易详情、创建费用类别等，使LLM能够执行具体的费用管理操作。
Prompt模板: 支持定义和渲染Prompt模板，虽然仓库信息中没有明确提及，但MCP服务器通常具备此能力，以便支持可定制的LLM交互模式。
标准化接口: 基于 MCP 协议，提供标准的 JSON-RPC 通信接口，确保与兼容 MCP 协议的客户端无缝集成。
多种传输协议: 支持 Stdio 和 SSE 等多种传输协议，满足不同应用场景的需求。

安装步骤

环境准备: 确保您的环境中已安装 Python 3.10 或更高版本。

安装工具包: 使用 pip 安装 'extend_ai_toolkit' 包。

pip install extend_ai_toolkit

获取API密钥: 您需要拥有 Extend API 的 API 密钥 (API Key) 和 API 密钥 (API Secret)。如果您还没有，请访问 paywithextend.com 注册并获取。

服务器配置

对于需要配置 MCP 服务器的 MCP 客户端（例如 Claude Desktop），您需要提供服务器的启动命令和参数。以下是 Claude Desktop 配置文件 'claude_desktop_config.json' 的配置示例，展示了如何配置 Extend MCP Server：

{
  "extend-mcp": { // 服务器名称，可以自定义，用于在客户端中标识
    "command": "python", // 启动服务器的命令，这里使用 python
    "args": [ // 启动参数列表
      "-m",
      "extend_ai_toolkit.modelcontextprotocol.main", // 指定运行的主模块为 main.py
      "--tools=all" // 启动参数，指定启用所有可用的工具。您也可以根据需要指定部分工具，例如 "--tools=get_virtual_cards,get_transactions"
    ],
    "env": { // 环境变量配置
      "EXTEND_API_KEY": "apik_YOUR_API_KEY", //  **请替换为您的 Extend API 密钥**
      "EXTEND_API_SECRET": "YOUR_API_SECRET"  // **请替换为您的 Extend API 密钥**
    }
  }
}

配置参数说明 (无需修改代码，仅供客户端配置参考):

'command': 指定启动 MCP 服务器的命令，通常为 'python'。
'args': 启动参数列表，用于配置服务器的行为。
- '-m extend_ai_toolkit.modelcontextprotocol.main': 指定运行 'extend_ai_toolkit.modelcontextprotocol.main' 模块，即启动 Extend MCP Server 的 Stdio 版本。
- '--tools=all': 指定服务器加载所有可用的工具。您可以替换 'all' 为具体的工具名称列表（用逗号分隔），以限制服务器提供的功能。
'env': 环境变量配置。
- 'EXTEND_API_KEY': 必须配置，您的 Extend API 密钥。
- 'EXTEND_API_SECRET': 必须配置，您的 Extend API 密钥。

基本使用方法

启动服务器: 根据您选择的传输协议，运行相应的命令启动 Extend MCP Server。

Stdio 传输 (适用于 MCP Inspector, Claude Desktop 等):

python -m extend_ai_toolkit.modelcontextprotocol.main --tools=all

SSE 传输 (适用于远程连接):

python -m extend_ai_toolkit.modelcontextprotocol.main_sse --tools=all --api-key="YOUR_API_KEY" --api-secret="YOUR_API_SECRET"

注意: 对于 SSE 传输，您需要在启动命令中直接提供 API 密钥和 API 密钥。

配置客户端: 在您的 MCP 客户端（例如 Claude Desktop），按照客户端的指引添加和配置 Extend MCP Server。您需要提供服务器的名称、启动命令、参数以及必要的环境变量（API 密钥等）。
使用客户端: 启动并连接客户端后，您就可以通过自然语言指令，利用 Extend MCP Server 提供的工具和资源，进行虚拟卡管理、交易查询、费用管理等操作了。具体的操作方式取决于您使用的 MCP 客户端的功能和界面。

关键词