汞mcp
用于与Mercury banking API交互的模型上下文协议（MCP）服务器，使用 Dedalus实验室 该服务器提供读取帐户数据和启动需要管理员批准的付款的工具。
特性
- 读取帐户数据：检索帐户信息、余额和交易历史记录
- 支付管理：创建需要管理员批准的付款条目模板
- 交易对手管理：访问付款交易对手信息
可用工具
get_accounts()-检索与Mercury帐户关联的所有帐户get_account(account_id)-获取特定帐户的详细信息get_transactions(account_id, limit, offset)-检索帐户的交易记录create_payment_entry_template(...)-创建需要管理员批准的付款条目get_counterparties()-获取与该账户关联的所有交易对手
先决条件
- Python 3.10+
- 具有适当权限的Mercury API令牌
安装
- 克隆存储库：
git clone
cd mercury-mcp- 安装依赖项：
pip install -e .- 设置环境变量：
cp .env.example .env填写您的 MERCURY_TOKEN 值（格式： secret-token:mercury_production_...).
配置
API代币
此服务器使用具有以下权限的Mercury API令牌：
- 阅读Mercury帐户上的所有可用数据
- 启动需要并等待管理员批准的付款（创建条目模板）
令牌使用说明：
- 在任何45天内未使用的代币将自动删除
- 权限高于其在45天窗口内使用的令牌会自动调整到适当的权限级别
- 为了进一步保护您的令牌，Mercury要求您将预期使用读写令牌的IP地址或范围列入白名单
环境变量
| 变量 | 描述 |
|---|---|
MERCURY_TOKEN | 您的Mercury API令牌，由DAuth连接使用 |
DEDALUS_AS_URL | Dedalus授权服务器URL（默认值： https://as.dedaluslabs.ai) |
DEDALUS_API_KEY | 您的Dedalus平台API密钥 |
用法
启动MCP服务器：
python -m src.main默认情况下，服务器将在端口8080上启动。
项目结构
mercury-mcp/
├── src/
│ ├── main.py # Entry point and server configuration
│ └── tools.py # Tool definitions and implementations
├── pyproject.toml # Project metadata and dependencies
├── .env.example # Environment variable reference
├── LICENSE
└── README.md替代方案：Mercury托管MCP服务器
Mercury提供了一个需要OAuth登录的托管MCP服务器，截至2026年1月，该服务器仍处于测试阶段。有关更多信息，请参阅：https://docs.mercury.com/docs/connecting-mercury-mcp
发展
本项目使用：
- Dedalus实验室MCP框架 用于MCP服务器实现
- 派丹蒂克 用于数据验证和类型安全
- 请求： 用于HTTP API调用
许可证
有关详细信息，请参阅LICENSE文件。