Ntropy MCP server

Ntropy MCP サーバー

Ntropy API を使用して銀行データを拡充する MCP サーバーです。これにより、金融データを扱う LLM エージェントは、Ntropy API の任意のエンドポイントを簡単に呼び出せます。

コンポーネント

ツール

このサーバーは、Ntropy API と連携するために次のツールを実装しています。

• check_connection：Ntropy API への接続を確認します

  • 戻り値：接続ステータス情報

• set_api_key：実行時に Ntropy API キーを設定または更新します

  • パラメーター：api_key（文字列）
  • 戻り値：API キーの更新および検証のステータス

• create_account_holder：口座名義人を作成します

  • パラメーター：id（文字列／整数）、type（文字列）、name（文字列）
  • 戻り値：作成した口座名義人の詳細

• update_account_holder：既存の口座名義人を更新します

  • パラメーター：id（文字列／整数）、name（文字列、省略可）、type（文字列、省略可）
  • 戻り値：更新した口座名義人の詳細

• enrich_transaction：銀行取引データを拡充します

  • パラメーター：id（文字列／整数）、description（文字列）、date（文字列）、amount（浮動小数点数）、entry_type（文字列）、currency（文字列）、account_holder_id（文字列／整数）、country（文字列、省略可）
  • 戻り値：拡充した取引データ

• get_account_holder：口座名義人の詳細を取得します

  • パラメーター：account_holder_id（文字列／整数）
  • 戻り値：口座名義人の詳細

• list_transactions：口座名義人の取引一覧を取得します

  • パラメーター：account_holder_id（文字列／整数）、limit（整数、デフォルト=10）、offset（整数、デフォルト=0）
  • 戻り値：取引一覧

• get_transaction：特定の取引の詳細を取得します

  • パラメーター：transaction_id（文字列／整数）
  • 戻り値：取引の詳細

• bulk_enrich_transactions：複数の取引を一度に拡充します

  • パラメーター：transactions（取引オブジェクトのリスト）
  • 戻り値：拡充した取引のリスト

• delete_account_holder：口座名義人と関連するすべてのデータを削除します

  • パラメーター：account_holder_id（文字列／整数）
  • 戻り値：削除ステータス

• delete_transaction：特定の取引を削除します

  • パラメーター：transaction_id（文字列／整数）
  • 戻り値：削除ステータス

クイックスタート

インストール

まず、ntropy.com でアカウントを作成し、Ntropy API キーを取得します。以下の YOUR_NTROPY_API_KEY を実際の API キーに置き換えてください。

uvx でサーバーを実行する

uvx ntropy-mcp --api-key YOUR_NTROPY_API_KEY

Claude Desktop

Claude Desktop の設定ファイルは通常、次の場所にあります。

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

uvx を使用する場合は、次の内容を設定ファイルに追加します。

  "mcpServers": {
    "ntropy-mcp": {
      "command": "uvx",
      "args": [
        "ntropy-mcp",
        "--api-key",
        "YOUR_NTROPY_API_KEY"
      ]
    }
  }

docker を使用する場合は、次の内容を追加します。

"mcpServers": {
  "ntropy-mcp": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "ntropy-mcp"
      "--api-key",
      "YOUR_NTROPY_API_KEY"
    ]
  }
}

使用例

接続の確認

# Check if your API key is valid and the Ntropy API is accessible
connection_status = check_connection()
print(connection_status)

口座名義人の作成と更新

# Create a new account holder
account_holder = create_account_holder(
    id="user123",
    type="individual",
    name="John Doe"
)

# Update an existing account holder
updated_account = update_account_holder(
    id="user123",
    name="John Smith"
)

取引データの拡充

# Enrich a single transaction
enriched_transaction = enrich_transaction(
    id="tx123",
    description="AMAZON.COM*MK1AB6TE1",
    date="2023-05-15",
    amount=-29.99,
    entry_type="debit",
    currency="USD",
    account_holder_id="user123",
    country="US"
)

# Bulk enrich multiple transactions
transactions = [
    {
        "id": "tx124",
        "description": "NETFLIX.COM",
        "date": "2023-05-16",
        "amount": -13.99,
        "entry_type": "debit",
        "currency": "USD",
        "account_holder_id": "user123"
    },
    {
        "id": "tx125",
        "description": "Starbucks Coffee",
        "date": "2023-05-17",
        "amount": -5.65,
        "entry_type": "debit",
        "currency": "USD",
        "account_holder_id": "user123"
    }
]
enriched_transactions = bulk_enrich_transactions(transactions)

デバッグ

MCP inspector を使用してサーバーをデバッグできます。uvx でインストールした場合：

npx @modelcontextprotocol/inspector uvx ntropy-mcp --api-key YOUR_NTROPY_API_KEY

ビルド

Docker のビルド：

docker build -t ntropy-mcp .

コントリビューション

プルリクエストを歓迎します。新しいアイデア、バグ修正、機能強化など、ぜひご協力ください。

ライセンス

ntropy-mcp は MIT License の下でライセンスされています。MIT License の利用規約に従う限り、このソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。