🚀 菲尼克斯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.comLive或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许可证。