Finix MCP

🚀 菲尼克斯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許可證。