Finix MCP

🚀 Finix MCP Server (Unofficial)

非公式のローカルMCP（Model Context Protocol）サーバーで、Finixの支払い処理機能に簡易的にアクセスできます。

⚠️ 重要提示

これは非公式の、コミュニティによって構築されたMCPサーバーです。Finixとは関係がなく、承認もされていません。

✨ 主な機能

• ドキュメント検索：MCP互換インターフェースを通じてFinixのドキュメントを検索できます。
• ID管理：簡略化されたパラメータでバイヤーとセラーを作成および一覧表示できます。
• 支払いリンク：マーチャントID、価格、数量のみで支払いリンクを作成できます。
• 簡素化されたAPI：すべてのツールがシンプルなパラメータを使用しており、使いやすくトークンの使用量も削減されています。

📦 インストール

npm install

📚 ドキュメント

設定

Finixの資格情報と環境を設定します。

export FINIX_USERNAME="your-username"
export FINIX_PASSWORD="your-password"
export FINIX_ENVIRONMENT="Sandbox"  # or "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" //Or 'Live' for Live
      }
    }
  }
}

利用可能なツール

search_finix_docs

Finixのドキュメントから関連情報を検索します。

パラメータ:

• query (文字列、必須): 関連するFinixドキュメントを見つけるための検索クエリ
• limit (数値、オプション): 返す結果の最大数（デフォルト: 10）
• category (文字列、オプション): ドキュメントのカテゴリでフィルタリングします（"api"、"docs"、または "all"）

create_buyer

必須情報を使用して新しいバイヤーIDを作成します。

パラメータ:

• email (文字列、必須): バイヤーのメールアドレス
• first_name (文字列、必須): 名前
• last_name (文字列、必須): 姓
• phone (文字列、必須): 電話番号

戻り値: {id: "buyer_id"}

create_seller

包括的なビジネス情報を使用して新しいセラーIDを作成します。

パラメータ:

• メールアドレス、ビジネス詳細、保険情報など、複数の必須フィールドがあります。
• 完全なパラメータリストはツールのスキーマを参照してください。

戻り値: すべての詳細を含む完全なセラーオブジェクト

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を使用
• MCPの実装に @modelcontextprotocol/sdk を使用
• HTTPリクエストにネイティブのfetch APIを使用
• 通信にStdioServerTransportを使用

📄 ライセンス

ISC