使用说明

本项目是一个基于Python实现的MCP（Model Context Protocol）服务器，专门用于连接Investec南非私行业务（SAPB）API。通过遵循MCP标准，它允许任何兼容MCP的AI应用程序（如Claude Desktop、5ire等）安全、便捷地与您的Investec银行账户进行交互，执行查询余额、查看交易、管理收款人或发起转账/支付等操作，无需为每个AI应用单独开发集成代码。

主要功能点

账户查询: 获取您的所有Investec银行账户信息，包括账户名称、账号、余额等。
交易明细: 查询指定账户的历史交易记录或待处理交易。
收款人管理: 查看您已保存的收款人列表。
资金转移: 在您自己的不同Investec账户之间进行资金划转。
收款人支付: 向您已添加的收款人发起支付。
配置灵活: 支持通过环境变量或'.env'文件配置Investec API凭据和环境（沙盒/生产）。

安装步骤

克隆仓库:

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

安装 'uv' 包管理器: 访问 uv安装指南安装 'uv'。

创建并激活虚拟环境:

uv venv .venv
source .venv/bin/activate  # macOS/Linux
# 或
.venv\Scripts\activate     # Windows

安装依赖:
```
uv sync
```

配置Investec API凭据: 在项目根目录下创建 '.env' 文件，并添加您的Investec API凭据：

INVESTEC_CLIENT_ID=your_client_id
INVESTEC_CLIENT_SECRET=your_client_secret
INVESTEC_API_KEY=your_api_key
INVESTEC_USE_SANDBOX=true  # 在测试环境使用沙盒，生产环境请设置为 false
INVESTEC_TIMEOUT=30        # API请求超时时间（秒）

将 'your_client_id', 'your_client_secret', 'your_api_key' 替换为您的实际凭据。请务必妥善保管您的凭据，切勿硬编码到代码中。

服务器配置（供MCP客户端使用）

要让您的MCP客户端（如兼容MCP的LLM应用）连接到此服务器，您需要在客户端的MCP连接配置中指定服务器信息。通常，这需要配置以下几个关键参数：

服务器名称 (server name): 一个唯一的标识符，用于客户端区分不同的MCP服务器。本项目使用的名称是 'investec'。
启动命令 (command): 客户端需要执行的命令行指令来启动服务器进程。在本例中，假设您已激活虚拟环境，命令是 'uv'。
命令参数 (args): 启动命令所需的额外参数。在本例中，参数列表是 '["run", "server.py"]'。
传输协议 (transport): 本项目服务器默认使用 'stdio' 协议进行通信，这是通过标准输入/输出来进行数据交换。大多数MCP客户端默认支持此协议。

请根据您使用的具体MCP客户端软件的配置界面或文件格式要求，填入上述 'investec'、'uv'、'["run", "server.py"]' 和 'stdio' 等信息来建立连接。

基本使用方法

启动MCP服务器: 在项目根目录（已激活虚拟环境）下执行：
```
uv run server.py
```
服务器将启动并等待MCP客户端连接。保持此终端窗口开启。
连接MCP客户端: 在您的MCP兼容AI应用程序中，添加一个新的MCP服务器连接，并按照上一步骤提供的服务器配置信息进行设置和连接。
通过AI与银行交互: 连接成功后，您可以通过AI应用程序使用自然语言与Investec API进行交互。例如：
- 询问："列出我的所有账户。" (AI可能调用 'get_accounts' 工具)
- 询问："查询账号[账户ID]的余额。" (AI可能调用 'get_account_balance' 工具)
- 询问："从我的[源账户ID]账户向[收款人ID]支付[金额]元，备注'测试支付'。" (AI可能调用 'pay_beneficiaries' 工具)

AI应用会根据您的问题，自动识别并调用MCP服务器暴露的对应工具，服务器则通过Investec API执行操作并将结果返回给AI。

关键词

使用说明

主要功能点

安装步骤

服务器配置（供MCP客户端使用）

基本使用方法

信息