银行API交互工具

一个基于Dedalus Labs框架的Mercury银行API交互工具,提供读取账户数据和发起需要管理员批准的支付功能。

  • by NickyHeC
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 NickyHeC/mercury-mcp

使用说明

汞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令牌

安装

  1. 克隆存储库:
git clone <repository-url>
cd mercury-mcp
  1. 安装依赖项:
pip install -e .
  1. 设置环境变量:
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

发展

本项目使用:

许可证

有关详细信息,请参阅LICENSE文件。