mercury-mcp 使用说明

项目简介

mercury-mcp 是一个简单的 MCP 服务器，它允许你通过任何 MCP 客户端（如 Cursor 或 Claude Desktop）访问你的 Mercury 银行数据。它通过 Mercury API 提供数据访问能力，目前提供查询银行账户信息的功能。

主要功能点

• 提供工具 (Tools) 'get_all_accounts'，用于获取 Mercury 银行账户信息。
• 基于 MCP 协议，可以与任何兼容的 MCP 客户端进行交互。
• 使用 Stdio 传输协议。

安装步骤

1. 获取 Mercury API 密钥: 访问 Mercury 设置 获取你的 Mercury API 密钥。

2. 选择安装方式:

   • 方式一：通过 Smithery 安装 (推荐给 Claude Desktop 用户)

     • 复制并运行以下命令：

       npx -y @smithery/cli install @dragonkhoi/mercury-mcp --client claude
       

   • 方式二：手动安装 (适用于 Cursor 或本地运行)

     • 克隆仓库到本地：

       git clone https://github.com/dragonkhoi/mercury-mcp.git
       

     • 进入项目目录：

       cd mercury-mcp
       

     • 安装项目依赖：

       npm install
       

     • 构建项目：

       npm run build
       

服务器配置 (MCP 客户端配置)

根据你的 MCP 客户端和安装方式，配置 MCP 服务器连接信息。

1. Cursor 配置 (Settings -> Cursor Settings -> Features -> MCP Servers -> + Add)

• 通过 Smithery 运行 (推荐):

  • 类型 (Type): 'command'
  • 命令 (Command): 'npx'
  • 参数 (Args): '-y @smithery/cli@latest run @dragonkhoi/mercury-mcp --config '{"mercury_api_key":"YOUR_MERCURY_API_KEY"}''
    • 参数注释:
      • 'YOUR_MERCURY_API_KEY': 请替换为你从 Mercury 官网获取的 API 密钥。

• 本地运行:

  • 类型 (Type): 'command'
  • 命令 (Command): 'node'
  • 参数 (Args): '/ABSOLUTE/PATH/TO/mercury-mcp/build/index.js YOUR_MERCURY_API_KEY'
    • 参数注释:
      • '/ABSOLUTE/PATH/TO/mercury-mcp/build/index.js': 请替换为 'mercury-mcp' 项目 'build/index.js' 文件的绝对路径。
      • 'YOUR_MERCURY_API_KEY': 请替换为你从 Mercury 官网获取的 API 密钥。

2. Claude Desktop 配置 (通过 Smithery 安装后自动配置)

• 如果你通过 Smithery 安装，Claude Desktop 会自动配置 mercury-mcp 服务器，无需手动配置。

基本使用方法

配置完成后，在你的 MCP 客户端 (如 Cursor 或 Claude Desktop) 中，你可以使用自然语言指令与 Mercury 银行数据进行交互。

例如，你可以提问：

• "What is my bank balance?" (我的银行账户余额是多少？)
• "Get all my accounts information." (获取我所有的账户信息。)

MCP 客户端会将你的问题发送到 mercury-mcp 服务器，服务器会调用 Mercury API 获取相关数据，并将结果返回给客户端。

请确保你的 Mercury API 密钥配置正确，并且你的 MCP 客户端已正确连接到 mercury-mcp 服务器。