mollie-mcp

使用说明内容（Markdown格式）

• 项目简介 这是一个基于 MCP（Model Context Protocol）的后端服务器实现，利用 Mollie 的官方 API 提供与 Mollie 支付相关的数据与操作工具，供 LLM 客户端在对话中查询支付信息、获取交易详情、创建支付链接、获取可用支付方法以及查询当前账户信息。服务器通过 MCP 规范的工具注册与 JSON-RPC 交互，支持通过标准传输（如标准输入/输出）与客户端通信。

• 主要功能点

  • 提供5个核心工具，供 MCP 客户端调用：
    • fetch-transactions：获取最近的 Mollie 交易列表（支持 limit 参数）。
    • transaction-info：获取指定交易的完整信息，支付ID 需以 tr_ 开头。
    • create-payment-link：基于给定金额创建 Mollie 支付链接。
    • fetch-methods：获取当前账户支持的支付方法列表。
    • profile-info：获取当前 Mollie 账户的配置信息。
  • 通过 Mollie API 客户端与 Mollie 后端服务交互，返回 JSON 字符串化的数据供 LLM 使用。
  • 环境变量加载与安全性考虑，需提供 Mollie API Key（MOLLIE_API_KEY）。
  • 使用 MCP SDK 提供的 MCP 服务器框架，结合 StdioTransport 实现与客户端的通信。

• 安装步骤

  1. 克隆仓库并进入目录。
  2. 安装依赖：在项目根目录执行安装命令。
  3. 设置环境变量：将示例环境变量文件复制为 .env，并填写真实 Mollie API Key。
  4. 构建项目：执行构建命令将 TypeScript 编译为可运行的 JavaScript（build/ 目录）。
  5. 运行 MCP 服务器：使用支持的 MCP 客户端（如通过配置 JSON 启动），服务器将通过标准输入输出与客户端通信。

• 服务器配置 MCP 客户端需要的最小配置信息（JSON 格式，包含 server 名称、启动命令及参数等）示例信息如下，客户端无需执行代码块，仅用于参考配置注解： { "servers": { "mollie-mcp": { "type": "stdio", "command": "node", "args": ["<absolute-path-to-repo>/build/index.js"] } // 说明：server 名称应与项目中的 MCP 服务标识一致，type 指定传输类型为 stdio，command 为执行 Node.js 的命令，args 指向构建产物的入口文件路径。 } } 注解：

  • 服务器名称与仓库实现中的 name 字段保持一致，便于 MCP 客户端定位与管理。
  • 通过该配置，MCP 客户端能够通过 JSON-RPC 与服务器建立连接，进而调用注册的工具。

• 基本使用方法

  • 启动后，MCP 客户端（LLM / 代理）将通过标准输入输出与 Mollie MCP 服务器建立通信。
  • 客户端可以调用以下工具执行具体操作：fetch-transactions、transaction-info、create-payment-link、fetch-methods、profile-info。
  • 服务器会返回符合 MCP 规范的 JSON-RPC 响应，包含查询结果的文本或 JSON 内容，LLM 可以将其用于回答用户的自然语言问题。