NextApp Payments MCP Server Demo

NextApp Payments MCP 服务演示

此演示项目展示了如何实现一个模型上下文协议（MCP）服务，通过 MCP Inspector 和 Claude AI 集成来提供 MongoDB 支付数据。本项目旨在示范如何使用 MCP 协议，通过标准化接口提供数据库资源。

📝 如需了解从头开始构建此 MCP 服务的详细分步指南，请查看我的完整博客文章。

项目概览

此演示项目展示了：

• 使用官方 SDK 实现 MCP 服务
• 连接到特定的 MongoDB Atlas 数据库
• 通过 MCP 资源和工具提供支付数据
• 与 MCP Inspector 和 Claude AI 集成
• 大模型如何与结构化数据库数据交互

功能

MCP 资源

• URI：payments://done
• 用途：检索 done: true 的支付记录
• 响应格式：JSON
• MIME 类型：application/json

MCP 工具

1. get_completed_payments

   • 描述：检索所有 done 为 true 的支付记录
   • 输入：无需参数
   • 输出：已完成支付记录的 JSON 数组

2. get_all_payments

   • 描述：检索数据库中的所有支付记录
   • 输入：无需参数
   • 输出：所有支付记录的 JSON 数组

MCP Inspector 界面

上图展示了 MCP Inspector 界面，其中显示了通过 MCP 服务从 MongoDB Atlas 检索的支付记录。MCP Inspector 是一款开发者工具，可帮助验证和调试 MCP 服务实现。

Claude AI 集成

上图展示了 Claude AI 成功完成以下操作：

• 连接到 MCP 服务
• 访问支付资源和工具
• 分析支付数据
• 呈现结构化结果，包括总金额、日期范围和关键观察结果

在 Claude Desktop 中设置 MCP 资源

如果你创建了自己的 MCP 服务，并希望在 Claude Desktop 中使用它：

1. 找到 Claude Desktop 配置文件

   • Windows：C:\Users\<username>\AppData\Roaming\claude\claude_desktop_config.json
   • macOS：~/Library/Application Support/claude/claude_desktop_config.json
   • Linux：~/.config/claude/claude_desktop_config.json

2. 配置你的 MCP 服务

   {
     "mcpServers": {
       "YourServerName": {
         "transport": "stdio",
         "command": "node",
         "args": ["path/to/your/server.js"],
         "env": {
           "YOUR_ENV_VARIABLE": "your_value"
         },
         "cwd": "path/to/your/project"
       }
     }
   }
   

   替换：

   • YourServerName：服务的唯一名称
   • path/to/your/server.js：服务文件的完整路径
   • YOUR_ENV_VARIABLE：服务所需的任意环境变量

3. 验证连接

   • 打开 Claude Desktop
   • 前往“设置” → “开发者”
   • 你的服务应显示“运行中”状态

4. 使用你的资源或工具

   # Using Resource
   Use the MCP resource payments://done and [your query]
   
   # Using Tools
   Use the MCP tool get_completed_payments to show me all successful payments
   Use the MCP tool get_all_payments to show me all payments in the system
   

实现细节

使用的技术

• MCP SDK：用于协议处理以及资源和工具的提供
• MongoDB Driver：用于数据库访问和查询执行
• Claude Desktop：用于大模型集成和自然语言查询

错误处理

此实现包含以下错误处理：

• MongoDB 连接问题
• 查询执行错误
• 连接关闭错误
• 兼容 Claude Desktop 的 JSON 格式日志记录

重要说明

这是一个演示项目，展示了：

1. 如何实现 MCP 服务
2. 如何将 MongoDB 数据作为 MCP 资源和工具提供
3. 多种访问数据的方式：
   • 通过 MCP Inspector（面向开发者）
   • 通过 Claude AI（面向终端用户）
   • 通过直接调用工具
4. 大模型如何与结构化数据交互

MongoDB 连接和资源配置仅适用于此演示。你需要根据自己的使用场景进行修改。

资源

• Model Context Protocol 文档
• Claude Desktop 文档
• MongoDB Node.js Driver 文档