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로 서버 실행

지엑스피1

클로드 데스크탑

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