xendit-mcp (読み取り専用)

Xendit用の最小限の読み取り専用MCPサーバーです。CareNow Issue Resolverエージェント向けに構築されており、支払い、送金、返金、VA（バーチャルアカウント）取引を検索します。資金移動は一切行いません。

非公式です。Xenditとは提携しておらず、推奨もされていません。

なぜ読み取り専用なのか？

エージェントは、Xendit側のフィールドからのプロンプトインジェクション経由であっても、create_disbursement、create_refund、expire_invoiceを呼び出せるべきではありません。このサーバーはGETエンドポイントのみを公開します。多層防御のため、*_READ権限に限定されたXendit APIキーを使用してください。

インストールと実行

クローンは不要です。npxを使用してGitHubから直接インストールします：

{
  "mcpServers": {
    "xendit": {
      "command": "npx",
      "args": ["-y", "github:indratjhai/xendit-mcp"],
      "env": {
        "XENDIT_API_KEY": "xnd_development_..."
      }
    }
  }
}

初回実行時に、npmがリポジトリをクローンし、依存関係をインストールし、prepareスクリプト経由でnpm run buildを実行します。その後はキャッシュされたインストールから起動します。

再現性のために特定のコミットを固定します：

"args": ["-y", "github:indratjhai/xendit-mcp#<commit-sha>"]

ローカル開発

git clone https://github.com/indratjhai/xendit-mcp.git
cd xendit-mcp
npm install
cp .env.example .env  # fill in XENDIT_API_KEY
npm run dev

APIキー

1. https://dashboard.xendit.co/settings/developers#api-keys にアクセスします。

2. 読み取り専用権限を持つキーを作成します：

   • BALANCE_READ

   • INVOICE_READ

   • TRANSACTION_READ

   • DISBURSEMENT_READ

   • REFUND_READ

   • PAYMENT_REQUEST_READ

3. 開発中は xnd_development_... テストキーを使用してください。

ツール

含まれていない機能（意図的な設計）

• create_invoice, expire_invoice

• create_disbursement

• create_refund

• create_payment_request

• すべての POST / PATCH / DELETE

ワークフローで変更が必要な場合は、Xenditダッシュボードで手動で行うか、人間がレビューする別の承認フローを通じて行うべきであり、エージェントセッションから行うべきではありません。

セキュリティに関する注意点

• APIキーは XENDIT_API_KEY 環境変数から読み取られます。ログには記録されず、ツール出力にも送信されません。

• ネットワークの送信先は https://api.xendit.co にハードコードされており、他のホストには接続しません。

• パスコンポーネントのIDは ^[a-zA-Z0-9_-]+$ に対して検証され、URLエンコードされます。

• すべてのツール入力はzodで検証されます。

• ランタイム依存関係は @modelcontextprotocol/sdk と zod のみです。

ライセンス

MIT