ntropy-mcp MCP Server

Official

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Supports enrichment of Amazon transactions, identifying and categorizing Amazon purchase data in banking records.

  • Supports enrichment of Netflix subscription transactions, identifying and categorizing streaming service payments in banking records.

  • Supports enrichment of Starbucks purchase transactions, identifying and categorizing coffee shop expenditures in banking records.

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 構成ファイルは通常、次の場所にあります。

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ファイルをご覧ください。

-
security - not tested
A
license - permissive license
-
quality - not tested

Ntropy API を使用して銀行データを拡充し、口座保有者を作成し、取引を効率的に拡充するためのツールを提供します。

  1. Components
    1. Tools
  2. Quickstart
    1. Install
  3. Example Usage
    1. Check Connection
    2. Create and Update Account Holders
    3. Enrich Transactions
  4. Debugging
    1. Build
      1. Contributing
        1. License
          ID: m67bltwfhr