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 (文字列/整数)
- 戻り値: 削除ステータス

Related MCP server: Alchemy MCP Plugin

クイックスタート

インストール

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

uvxでサーバーを実行する

uvx ntropy-mcp --api-key YOUR_NTROPY_API_KEY

クロードデスクトップ

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インスペクタを使用してサーバーをデバッグできます。UVXインストールの場合：

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

建てる

Dockerビルド:

docker build -t ntropy-mcp .

貢献

プルリクエストは大歓迎です！新しいアイデア、バグ修正、機能強化など、お気軽にご投稿ください。

ライセンス

ntropy-mcpはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

ntropy-mcp MCP Server