使用说明
MCP炼金服务器
一种模型上下文协议(MCP)服务器,提供对XB数据库中事务数据的访问。此服务器旨在与MCP客户端(如Claude Desktop或其他AI代理)一起使用,以检索金融交易详细信息。
特征
- 付款交易查询:使用UUID或客户端交易ID检索支付交易详细信息。
- MCP标准:使用
fastmcpSDK,兼容任何MCP客户端。
先决条件
- Python 3.12或更高版本
- 紫外线 (建议用于依赖关系管理)
安装
-
克隆存储库:
git clone <repository-url> cd oncall-mcp -
安装依赖项:
uv sync
配置
-
复制示例环境文件:
cp .env.example .env -
编辑
.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