investec-mcp

概述

功能

账户信息

1. get_accounts: 获取认证用户的所有账户

2. get_account_balance: 获取指定账户的余额

3. get_account_transactions: 获取指定账户的交易记录，支持过滤选项

4. get_pending_transactions: 获取指定账户的待处理交易

档案管理

1. get_profiles: 获取用户已授权的所有档案

2. get_profile_accounts: 获取指定档案的账户

3. get_profile_beneficiaries: 获取指定档案和账户的受益人

4. get_authorisation_setup_details: 获取需要审批的付款的授权设置详情

受益人管理

1. get_beneficiaries: 获取所有已保存的受益人

2. get_beneficiary_categories: 获取所有受益人分类

转账与支付

1. transfer_money: 在用户自己的账户之间转账（便捷方法）

2. transfer_multiple: 批量转账至一个或多个账户

3. pay_beneficiary: 向已保存的受益人付款（便捷方法）

4. pay_multiple: 批量向多个受益人付款

文档管理

1. get_documents: 获取指定账户在特定日期范围内的文档列表

2. get_document: 按类型和日期获取特定文档

先决条件

• Python 3.12+

• Investec 开发者账户及 API 凭证

• 如果以容器方式运行 MCP 服务器，需安装 Docker（推荐）

安装

使用 uv

1. 克隆本仓库：

2. 安装依赖：

3. 基于 .env.example 创建 .env 文件：

4. 在 .env 文件中配置环境变量，填入你的 Investec API 凭证

使用 Docker（推荐）

1. 构建 Docker 镜像：

2. 基于 .env.example 创建 .env 文件并配置环境变量

配置

运行服务器

使用 uv

SSE 传输

Stdio 传输

使用 Docker

SSE 传输

Stdio 传输

与 MCP 客户端集成

SSE 配置

Windsurf 用户注意: 在配置中使用 serverUrl 而不是 url：

Python 与 Stdio 配置

Docker 与 Stdio 配置

安全注意事项

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 中导入并注册新的工具函数。