Wise MCP 服务器

一个 MCP（机器通信协议）服务器，作为 Wise API 的网关，提供对 Wise 收款人功能的简化访问。

功能

通过简单的 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：直接安装

克隆此仓库：
```
git clone repo-url
cd jc-wise-mcp
```

设置环境：

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

使用 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 文件以匹配您选择的模式。我们提供了可供使用的模板文件：

对于 stdio 模式（默认）：
```
cp .mcp.json.stdio .mcp.json
```
对于 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：设置为 true 以使用 Wise 沙盒 API（默认：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

添加新功能

要添加新功能：

在 src/wise_mcp/api/wise_client.py 中添加新的 API 客户端方法
在 src/wise_mcp/resources/ 中创建新资源
在 src/wise_mcp/app.py 中导入并注册新资源

贡献

欢迎贡献！请随时提交拉取请求 (Pull Request)。

许可证

MIT

Wise MCP Server