Wise MCP 서버

Wise API의 게이트웨이 역할을 하며 Wise의 수취인 기능에 대한 간소화된 액세스를 제공하는 MCP(Machine Communication Protocol) 서버입니다.

주요 기능

• 간단한 MCP 리소스를 통해 Wise 계정의 모든 수취인 목록 조회

• 인증 및 프로필 선택 자동 처리

• 개발 및 테스트를 위한 Wise 샌드박스 API 사용

• 간편한 통합을 위한 Docker 이미지 제공

요구 사항

• Python 3.12 이상 (직접 설치 시)

• uv 패키지 관리자 (직접 설치 시)

• Wise API 토큰

• Docker (Docker 이미지 사용 시)

API 토큰 발급

https://wise.com/your-account/integrations-and-tools/api-tokens

여기에서 새 토큰을 생성하세요.

설치 방법

옵션 1: 직접 설치

1. 저장소 복제:

   git clone repo-url
   cd jc-wise-mcp

2. 환경 설정:

   cp .env.example .env
   # Edit .env to add your Wise API token

3. uv를 사용하여 의존성 설치:

   uv venv
   uv pip install -e .

옵션 2: Docker 사용

Docker 이미지를 빌드할 수 있습니다:

docker build -t mcp-wise .

.mcp.json에 추가하여 Claude Code에 등록하세요.

{
  "mcpServers": {
    "mcp-wise": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e", "WISE_API_TOKEN=your_api_token_here",
        "-e", "WISE_IS_SANDBOX=true",
        "mcp-wise:latest"
      ]
    }
  }
}

your_api_token_here를 실제 Wise API 토큰으로 교체해야 합니다.

또한 선택한 모드에 맞게 .mcp.json 파일을 업데이트해야 합니다. 사용할 수 있는 템플릿 파일은 다음과 같습니다:

1. stdio 모드 (기본값):

   cp .mcp.json.stdio .mcp.json

2. HTTP 모드:

   cp .mcp.json.http .mcp.json

이 템플릿 파일에는 각 모드에 적합한 구성이 포함되어 있습니다.

사용 가능한 MCP 리소스

이 서버는 다음과 같은 MCP 리소스를 제공합니다:

list_recipients

Wise 계정의 모든 수취인 목록을 반환합니다.

매개변수:

• profile_type: 수취인 목록을 가져올 프로필 유형입니다. [personal, business] 중 하나. 기본값: "personal"

• currency: 선택 사항. 통화 코드(예: 'EUR', 'USD')로 수취인 필터링

get_recipient_requirements

새 수취인을 생성하기 위한 요구 사항을 가져옵니다. 계정 세부 정보가 제공되면 요구 사항에 따라 계정 세부 정보를 검증합니다.

매개변수:

• source_currency: 송금 통화 코드(예: 'USD')

• target_currency: 수취 통화 코드(예: 'EUR')

• source_amount: 송금 통화 금액

• profile_type: 사용할 프로필 유형입니다. [personal, business] 중 하나. 기본값: "personal"

• account: 선택 사항. 요구 사항에 대해 검증할 수취인 계정 세부 정보입니다. 제공되지 않으면 초기 계정 요구 사항을 반환합니다.

create_recipient

제공된 계정 세부 정보로 새 수취인을 생성합니다.

매개변수:

• profile_type: 사용할 프로필 유형입니다. [personal, business] 중 하나. 기본값: "personal"

• account: Wise API 요구 사항을 준수하는 수취인 계정 세부 정보입니다. 다음을 포함해야 합니다:

  • accountHolderName: 계좌 소유자 이름

  • currency: 수취 통화 코드(예: 'EUR')

  • type: 계좌 유형(예: 'iban', 'sort_code' 등)

  • details: 계좌별 세부 정보가 포함된 객체(통화 및 국가에 따라 다름)

send_money

Wise API를 사용하여 수취인에게 송금합니다.

매개변수:

• profile_type: 사용할 프로필 유형(personal 또는 business)

• source_currency: 송금 통화 코드(예: 'USD')

• source_amount: 송금할 송금 통화 금액

• recipient_id: 송금할 수취인의 ID

• payment_reference: 선택 사항. 송금 참조 메시지(기본값: "money")

• source_of_funds: 선택 사항. 자금 출처(예: "salary", "savings")

구성

구성은 .env 파일에 설정할 수 있는 환경 변수를 통해 수행됩니다:

• WISE_API_TOKEN: Wise API 토큰 (필수)

• WISE_IS_SANDBOX: Wise 샌드박스 API를 사용하려면 true로 설정 (기본값: false)

• MODE: MCP 서버 전송 모드, "http" 또는 "stdio" (기본값: stdio)

개발

프로젝트 구조

wise-mcp/
├── .env                # Environment variables (not in git)
├── .env.example        # Example environment variables
├── pyproject.toml      # Project dependencies and configuration
├── README.md           # This file
└── src/                # Source code
    ├── main.py         # Entry point
    └── wise_mcp/       # Main package
        ├── api/        # API clients
        │   └── wise_client.py # Wise API client
        ├── resources/  # MCP resources
        │   └── recipients.py  # Recipients resource
        └── app.py      # MCP application setup

새로운 기능 추가

새 기능을 추가하려면:

1. src/wise_mcp/api/wise_client.py에 새로운 API 클라이언트 메서드 추가

2. src/wise_mcp/resources/에 새로운 리소스 생성

3. src/wise_mcp/app.py에서 새 리소스를 가져와 등록

기여

기여를 환영합니다! 자유롭게 Pull Request를 제출해 주세요.

라이선스

MIT