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

지엑스피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 파일을 참조하세요.

ntropy-mcp MCP Server