金融交易查询服务

MCP Alchemy Server 是一个基于 Model Context Protocol (MCP) 的服务,提供从 XB 数据库检索金融交易详细信息的功能,适用于 MCP 客户端(如 Claude Desktop 或其他 AI 代理)。

  • by febriansyahnr
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 febriansyahnr/oncall-mcp

使用说明

MCP炼金服务器

一种模型上下文协议(MCP)服务器,提供对XB数据库中事务数据的访问。此服务器旨在与MCP客户端(如Claude Desktop或其他AI代理)一起使用,以检索金融交易详细信息。

特征

  • 付款交易查询:使用UUID或客户端交易ID检索支付交易详细信息。
  • MCP标准:使用 fastmcp SDK,兼容任何MCP客户端。

先决条件

  • Python 3.12或更高版本
  • 紫外线 (建议用于依赖关系管理)

安装

  1. 克隆存储库:

    git clone <repository-url>
    cd oncall-mcp
    
  2. 安装依赖项:

    uv sync
    

配置

  1. 复制示例环境文件:

    cp .env.example .env
    
  2. 编辑 .env 并添加数据库连接字符串:

    XB_DATABASE_URL="mysql+pymysql://user:password@host:port/database"
    SNAP_DATABASE_URL="mysql+pymysql://user:password@host:port/database"
    

运行服务器

开发/本地运行

要在本地以热重新加载的方式运行服务器(如果运行程序支持)或进行测试:

uv run main.py

与MCP客户端一起使用

您可以配置MCP客户端以直接运行此服务器。例如,在 claude_desktop_config.json:

{
  "mcpServers": {
    "PivotOnCall": {
        "serverUrl": "http://localhost:8000/mcp"
    }
  }
}

可用工具

get_payout_transaction

从XB数据库中检索支出交易。

  • 参数:

    • identifier (string):UUID或客户端事务ID。
    • by_client_id (布尔值,可选):设置为 True 如果按客户端事务ID搜索,则默认为 False (UUID)。
  • 示例提示

check payout transaction with this uuid bc09aa1e-005a-48da-9837-bf68fa4969a9
check payout transaction with this client id 0199fd4f-b542-79fd-9666-a4b8397ace29