项目简介

Mono银行MCP服务器是一个专门为AI助手设计的后端服务，它遵循Model Context Protocol (MCP) 标准，使AI能够安全、高效地与尼日利亚的银行系统进行交互。通过集成Mono Open Banking API，该服务器提供了账户管理、实时支付、BVN验证以及其他多种银行操作功能，极大地扩展了AI助手在金融领域的应用能力。

主要功能点

账户管理: 列出、查询和获取您的所有关联银行账户的详细信息，包括余额和交易历史。
实时支付: 支持通过Mono DirectPay发起和验证支付，确保交易安全。
身份验证: 能够查询银行验证码 (BVN) 进行身份验证，并验证收款账户名称。
银行目录: 提供尼日利亚所有支持银行的列表及其代码。
账户绑定: 协助新用户启动银行账户绑定流程。

安装步骤

克隆仓库:

git clone https://github.com/sin4ch/mono-mcp.git
cd mono-mcp

安装依赖: 推荐使用'uv'包管理器（如果未安装，请先安装'uv'）。

# 安装所有依赖（包括运行时和开发依赖）
uv sync
# 或者如果uv不可用，使用pip
# pip install -e ".[dev]"

配置环境: 复制示例环境变量文件：
```
cp .env.example .env
```
编辑'.env'文件，填入您的Mono API 'MONO_SECRET_KEY'、'MONO_PUBLIC_KEY'、'MONO_WEBHOOK_SECRET'、'MONO_BASE_URL'和'MONO_ENVIRONMENT'（您可以在Mono控制台获取这些信息）。

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

要将此MCP服务器集成到您的MCP客户端（例如Claude Desktop或GitHub Copilot），您需要提供以下启动信息。这些信息通常以JSON格式配置，用于指导MCP客户端如何启动并连接到此服务器。

配置示例（JSON格式，请根据您的实际路径和密钥替换）：

{
  "serverName": "mono-banking",
  "command": "uv",
  "args": [
    "run",
    "python",
    "-m",
    "mono_banking_mcp.server"
  ],
  "cwd": "/path/to/mono-mcp",
  "env": {
    "MONO_SECRET_KEY": "您的Mono Secret Key",
    "MONO_BASE_URL": "https://api.withmono.com",
    "MONO_ENVIRONMENT": "sandbox 或 production"
  }
}

'serverName': 服务器的标识名称，例如'mono-banking'，用于在MCP客户端中识别。
'command': 启动MCP服务器所使用的命令，推荐使用'uv'来运行Python模块。
'args': 传递给'command'的参数列表，用于指定启动 'mono_banking_mcp.server' 模块。
'cwd': 服务器的运行目录，应指向您克隆'mono-mcp'仓库的根路径。
'env': 运行服务器所需的环境变量，包括您的Mono API密钥和其他配置。请务必替换为您自己的实际密钥和环境设置。

基本使用方法

一旦MCP服务器与AI助手（如Claude、Gemini或GitHub Copilot）成功连接，您就可以通过自然语言与AI助手交互，调用服务器提供的银行工具。

示例命令:

"列出我所有关联的银行账户"
"查询账户 'abc123' 的余额"
"验证 GTBank (代码 058) 的账户 '0123456789' 的账户名"
"向 Access Bank 的账户 '1234567890' 支付 ₦5000 给 John Doe"
"查询支付参考 'PAY_ABC123' 的状态"
"显示所有支持的尼日利亚银行和它们的代码"
"使用 BVN '12345678901' 进行身份验证"
"为新客户启动账户绑定流程"

关键词

项目简介

主要功能点

安装步骤

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

基本使用方法

信息