Investec MCP: Banking API for AI Agents

Investec MCP：面向 AI Agent 的银行 API

一个 模型上下文协议（MCP） 服务实现，可与 Investec Open Banking API 集成，让 AI Agent 能够访问银行信息并执行交易。

概述

本项目提供一个 MCP 服务，让 AI Agent 能够与 Investec Open Banking API 交互。它遵循 Anthropic 制定的 MCP 服务构建最佳实践，可与 Claude 等任何兼容 MCP 的客户端无缝集成。

功能

该服务基于 Investec Open Banking API 提供全面的银行工具：

账户信息

1. get_accounts：获取已通过身份验证的用户的所有账户
2. get_account_balance：获取指定账户的余额
3. get_account_transactions：获取指定账户的交易记录，并提供筛选选项
4. get_pending_transactions：获取指定账户的待处理交易

配置文件管理

5. get_profiles：获取用户已授权的所有配置文件
6. get_profile_accounts：获取指定配置文件的账户
7. get_profile_beneficiaries：获取指定配置文件和账户的收款人
8. get_authorisation_setup_details：获取需要审批的付款的授权设置信息

收款人管理

9. get_beneficiaries：获取所有已保存的收款人
10. get_beneficiary_categories：获取所有收款人类别

转账和付款

11. transfer_money：在自己的账户之间转账（便捷方法）
12. transfer_multiple：批量向一个或多个账户转账
13. pay_beneficiary：向已保存的收款人付款（便捷方法）
14. pay_multiple：批量向多个收款人付款

文档管理

15. get_documents：获取日期范围内某个账户的文档列表
16. get_document：按类型和日期获取特定文档

前提条件

• Python 3.12+
• Investec Developer 账户及 API 凭据
• 如果将 MCP 服务作为容器运行，则需要 Docker（推荐）

安装

使用 uv

1. 克隆此仓库：

   git clone https://github.com/yourusername/investec-mcp.git
   cd investec-mcp
   

2. 安装依赖项：

   uv pip install -e .
   

3. 根据 .env.example 创建 .env 文件：

   cp .env.example .env
   

4. 在 .env 文件中配置 Investec API 凭据对应的环境变量

使用 Docker（推荐）

1. 构建 Docker 镜像：

   docker build -t investec/mcp --build-arg PORT=8050 .
   

2. 根据 .env.example 创建 .env 文件并配置环境变量

配置

可以在 .env 文件中配置以下环境变量：

变量	描述	示例
TRANSPORT	传输协议（sse 或 stdio）	sse
HOST	使用 SSE 传输时绑定的主机	0.0.0.0
PORT	使用 SSE 传输时监听的端口	8050
INVESTEC_CLIENT_ID	Investec Developer Portal 中的客户端 ID	your-client-id
INVESTEC_CLIENT_SECRET	Investec Developer Portal 中的客户端密钥	your-client-secret
INVESTEC_API_KEY	Investec Developer Portal 中的 API 密钥	your-api-key

运行服务

使用 uv

SSE 传输

# Set TRANSPORT=sse in .env then:
uv run python src/main.py

MCP 服务将作为 API 端点运行，你可以连接到该端点。

Stdio 传输

使用 stdio 时，MCP 客户端本身可以启动 MCP 服务。

使用 Docker

SSE 传输

docker run --env-file .env -p 8050:8050 investec/mcp

MCP 服务将在容器内作为 API 端点运行，你可以连接到该端点。

Stdio 传输

使用 stdio 时，MCP 客户端本身可以启动 MCP 服务容器。

与 MCP 客户端集成

SSE 配置

使用 SSE 传输启动服务后，可以通过以下配置连接：

{
  "mcpServers": {
    "investec": {
      "transport": "sse",
      "url": "http://localhost:8050/sse"
    }
  }
}

Windsurf 用户须知：请在配置中使用 serverUrl，而不是 url：

{
  "mcpServers": {
    "investec": {
      "transport": "sse",
      "serverUrl": "http://localhost:8050/sse"
    }
  }
}

如果使用的端口不是默认的 8050，请务必更新端口。

Python 配合 Stdio 配置

将此服务添加到 Claude Desktop、Windsurf 或任何其他 MCP 客户端的 MCP 配置中：

{
  "mcpServers": {
    "investec": {
      "command": "path/to/python",
      "args": ["path/to/investec-mcp/src/main.py"],
      "env": {
        "TRANSPORT": "stdio",
        "INVESTEC_CLIENT_ID": "your-client-id",
        "INVESTEC_CLIENT_SECRET": "your-client-secret",
        "INVESTEC_API_KEY": "your-api-key"
      }
    }
  }
}

Docker 配合 Stdio 配置

{
  "mcpServers": {
    "investec": {
      "command": "docker",
      "args": ["run", "--rm", "-i", 
               "-e", "TRANSPORT", 
               "-e", "INVESTEC_CLIENT_ID", 
               "-e", "INVESTEC_CLIENT_SECRET", 
               "-e", "INVESTEC_API_KEY", 
               "investec/mcp"],
      "env": {
        "TRANSPORT": "stdio",
        "INVESTEC_CLIENT_ID": "your-client-id",
        "INVESTEC_CLIENT_SECRET": "your-client-secret",
        "INVESTEC_API_KEY": "your-api-key"
      }
    }
  }
}

安全注意事项

此 MCP 服务需要敏感的银行凭证。请务必：

1. 妥善保管 .env 文件，切勿将其提交到版本控制系统
2. 如果构建并分发容器镜像，请使用安全、私有的 Docker 镜像仓库
3. 仅在安全、可信的网络中运行此服务
4. 考虑实施其他安全措施，例如请求速率限制

扩展服务

如需添加更多功能：

1. 在 src/utils.py 中的 InvestecClient 类中添加新方法，以调用所需的 Investec API 端点。
2. 在 src/tools/ 目录中相关的 Python 文件内创建新的工具函数（例如，在 src/tools/accounts.py 中创建与账户相关的工具）。为这些函数使用 @mcp.tool() 装饰器。
3. 在 src/main.py 中导入并注册新的工具函数。