Wise

@mindstone/mcp-server-wise

面向 Model Context Protocol 主机的 Wise（原名 TransferWise）MCP 服务。通过标准化的 MCP 接口查看多币种余额和汇率、查看交易和活动、管理收款人、获取转账报价；明确选择启用后，还可创建、为转账注资和取消转账。

状态

• 版本： 0.1.1 · npm
• 身份验证： API 令牌（环境变量，或通过 WISE_CONFIG_PATH 存储在磁盘上）
• 工具： 17（账户、余额、收款人、报价、转账、发现）
• 接口类型： cloud-api
• 机器可读： STATUS.json

要求

• Node.js 20+
• npm
• Wise API 令牌：wise.com → 设置 → API 令牌

一键安装

点击按钮后，主机将提示你填写：WISE_API_TOKEN。

{
  "mcpServers": {
    "Wise": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-wise"
      ],
      "env": {
        "WISE_API_TOKEN": ""
      }
    }
  }
}

快速开始

安装和构建

cd <path-to-repo>/connectors/wise
npm install
npm run build

npx（发布后使用）

npx -y @mindstone/mcp-server-wise

本地

node dist/index.js

配置

环境变量

• WISE_API_TOKEN — Wise API 令牌。也可通过 configure_wise 工具连接；如果设置了此变量，其优先级高于任何已存储的令牌。
• WISE_ENVIRONMENT — production（默认）或 sandbox。Sandbox 需要使用在 Wise sandbox 中创建的令牌。
• WISE_CONFIG_PATH — 存储由 configure_wise 写入的令牌的配置目录路径（默认为 ~/.mcp/wise）。
• WISE_REQUEST_TIMEOUT_MS — 出站请求超时时间，单位为毫秒（默认 30000）。
• MCP_HOST_BRIDGE_STATE — 可选的主机桥接状态文件路径，用于凭据管理。
• MINDSTONE_REBEL_BRIDGE_STATE — 与 MCP_HOST_BRIDGE_STATE 向后兼容的别名。

主机配置示例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Wise": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-wise"],
      "env": {
        "WISE_API_TOKEN": "your-wise-api-token"
      }
    }
  }
}

本地开发（无需发布到 npm）

{
  "mcpServers": {
    "Wise": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/wise/dist/index.js"],
      "env": {
        "WISE_API_TOKEN": "your-wise-api-token"
      }
    }
  }
}

工具（17 个）

账户管理

• configure_wise — 使用 API 令牌连接 Wise 账户（存储前会通过 Wise API 验证）
• remove_wise_account — 断开 Wise 账户

个人资料和余额

• list_wise_profiles — 列出令牌可访问的个人和企业资料；将其 ID 用作 profile_id
• list_wise_balances — 列出余额（多币种账户和储蓄罐），并显示每种货币的金额
• get_wise_balance_statement — 查看指定时间范围内某个余额的交易账单（最长 469 天）
• list_wise_activities — 按时间顺序列出活动动态（转账、银行卡付款、存款）及其状态

汇率与报价

• get_wise_exchange_rate — 两种货币之间当前或历史的市场中间汇率
• create_wise_quote — 锁定汇率并获取按入金方式划分的确切费用（不会转移资金）

收款人

• list_wise_recipients — 列出已保存的收款人（银行账户），可按货币或类型筛选
• get_wise_recipient — 获取一位收款人的完整详情，包括银行信息
• get_wise_recipient_requirements — 根据报价，查看 Wise 对该转账路径要求填写的银行信息字段
• create_wise_recipient — 创建已保存的收款人（不会转移资金）

转账

• list_wise_transfers — 列出转账，并可按状态、货币和创建日期范围筛选
• get_wise_transfer — 获取一笔转账的当前状态
• create_wise_transfer — 根据报价向收款人创建转账（尚未入金）
• fund_wise_transfer — 从 Wise 余额为已创建的转账入金（会转移资金）
• cancel_wise_transfer — 在 funds_converted 阶段之前取消转账

典型的付款流程

1. list_wise_profiles → 选择一个 profile_id
2. create_wise_quote — 计算转账费用并锁定汇率
3. （新收款人）get_wise_recipient_requirements → create_wise_recipient
4. create_wise_transfer — 创建转账（尚未入金）
5. fund_wise_transfer — 从 Wise 余额付款；此步骤会转移资金

安全

• 默认会执行资金转移。 create_wise_transfer、fund_wise_transfer 和 cancel_wise_transfer 始终可用，并声明了 destructiveHint: true——是否对单次调用进行限制，由宿主的工具审批层负责，而非连接器。创建报价和收款人不会转移资金；只有 fund_wise_transfer 会从余额中扣款。
• 不可信内容封装。 外部参与方撰写的字符串（收款人姓名和银行信息、转账备注、账单描述和商户名称、活动标题、报价通知）会封装在 <untrusted-content source="…"> 中，以便宿主 LLM 将其视为数据而非指令。由连接器控制的元数据（ID、金额、货币、状态、时间戳）则以原始形式返回。
• 凭据存储。 configure_wise 写入的令牌会存储在 WISE_CONFIG_PATH 下的 credentials.json 中，权限为 0600（配置目录权限为 0700）。只会联系两个固定的 Wise 主机（api.wise.com、api.wise-sandbox.com），不支持任意覆盖基础 URL。
• 错误信息处理。 供应商错误正文、原始 Retry-After 标头文本以及包含查询参数的 URL，绝不会写入日志或显示在工具错误中；错误消息中也不会出现令牌。
• 幂等创建转账。 create_wise_transfer 使用 customer_transaction_id 作为 Wise 幂等键，因此重试不会创建重复转账。
• 输入验证。 在发出任何请求之前，都会验证货币代码、数字 ID、UUID 和日期时间范围。

许可

FSL-1.1-MIT — 功能源代码许可证，1.1 版，未来许可证为 MIT。该软件将于 2030-04-08 转为 MIT 许可证。