JinDaGe - finix-mcp MCP Details

article

README

🚀 菲尼克斯MCP服务器（非官方）

这是一个非官方的本地MCP（模型上下文协议）服务器，它简化了对菲尼克斯支付处理功能的访问。

⚠️ 这是一个由社区构建的非官方MCP服务器，它与菲尼克斯没有关联，也未得到菲尼克斯的认可。

🚀 快速开始

本非官方的菲尼克斯MCP服务器，能让你轻松访问菲尼克斯支付处理功能。按照以下步骤操作，即可快速上手。

✨ 主要特性

文档搜索：通过兼容MCP的接口搜索菲尼克斯文档。
身份管理：使用简化参数创建和列出买家与卖家。
支付链接：只需提供商户ID、价格和数量，即可创建支付链接。
精简API：所有工具都使用简单参数，便于使用并减少令牌使用量。

📦 安装指南

执行以下命令安装所需依赖：

npm install

📚 详细文档

配置

设置你的菲尼克斯凭证和环境：

export FINIX_USERNAME="your-username"
export FINIX_PASSWORD="your-password"
export FINIX_ENVIRONMENT="Sandbox"  # 或 "Live"

环境选项：

Sandbox（默认） - 使用 https://finix.sandbox-payments-api.com
Live 或 Production - 使用 https://finix.live-payments-api.com

使用方法

启动服务器

启动MCP服务器：

npm start

若要在开发环境中实现自动重载：

npm dev

构建TypeScript

npm run build

与Claude Code集成

将以下配置添加到你的Claude Code mcp文件中：

{
  "mcpServers": {
    "finix-docs": {
      "command": "npx",
      "args": ["tsx", "/path/to/finix-mcp/server.ts"],
      "env": {
        "FINIX_USERNAME": "your-username",
        "FINIX_PASSWORD": "your-password",
        "FINIX_ENVIRONMENT": "Sandbox" // 或 'Live' 用于生产环境
      }
    }
  }
}

可用工具

search_finix_docs

在菲尼克斯文档中搜索相关信息。

参数：

query（字符串，必填）：用于查找相关菲尼克斯文档的搜索查询。
limit（数字，可选）：返回的最大结果数（默认值：10）。
category（字符串，可选）：按文档类别过滤（"api"、"docs" 或 "all"）。

create_buyer

使用基本信息创建新的买家身份。

参数：

email（字符串，必填）：买家的电子邮件地址。
first_name（字符串，必填）：名字。
last_name（字符串，必填）：姓氏。
phone（字符串，必填）：电话号码。

返回值：{id: "buyer_id"}

create_seller

使用全面的业务信息创建新的卖家身份。

参数：

多个必填字段，包括电子邮件、业务详情和承保信息。
完整的参数列表请参阅工具架构。

返回值：包含所有详细信息的完整卖家对象。

list_buyers

使用简单的过滤条件获取买家列表。

参数：

limit（数字，可选）：返回的买家数量（1 - 100）。
email（字符串，可选）：按电子邮件地址过滤。

返回值：[{id: "buyer_id"}, ...]

list_sellers

使用简单的过滤条件获取卖家列表。

参数：

limit（数字，可选）：返回的卖家数量（1 - 100）。
email（字符串，可选）：按电子邮件地址过滤。

返回值：[{id: "seller_id"}, ...]

create_payment_link

创建用于处理支付的支付链接。

参数：

merchant_id（字符串，必填）：商户的ID。
price（数字，必填）：单位价格（以美分为单位）。
quantity（数字，必填）：产品数量。

返回值：{id: "payment_link_id", url: "https://..."}

🔧 技术细节

该服务器采用以下技术构建：

TypeScript：确保类型安全。
@modelcontextprotocol/sdk：实现MCP。
原生fetch API：用于HTTP请求。
StdioServerTransport：用于通信。

📄 许可证

本项目采用ISC许可证。

finix-mcp