交易数据库访问服务

通过SSH代理模式提供对生产交易数据库的只读访问,用于投资组合监控和交易分析。

  • by locupleto
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 locupleto/mcp-trade-db

使用说明

mcp贸易数据库

MCP(模型上下文协议)服务器,用于通过SSH代理模式访问生产交易数据库。

概述

此服务器为Claude Code提供对直播的只读访问权限 trade.db 在Mac mini生产服务器上。它使用SSH远程执行SQLite查询,实现投资组合监控和交易分析,而无需复制敏感的生产数据。

建筑

Mac Studio (Claude Code) → SSH → Mac mini (trade.db)

MCP服务器在本地运行,但通过SSH将所有数据库查询代理到生产服务器。这确保了:

  • 实时生产数据访问
  • 无本地数据副本
  • 安全的SSH身份验证连接
  • 只读查询

工具

工具 说明
get_open_positions 当前投资组合持有量,包括入场日期、价格、股票和损益
get_portfolio_summary 快速概述:总股本、现金、头寸价值、日常活动
get_pending_exits 检测到退出信号的头寸,计划在下一个交易日进行
get_recent_trades 最近结束的交易,包括进入/退出详细信息和损益表
get_position_details 特定符号的详细信息,包括指示器
get_trade_database_status 连接状态和基本统计

配置

环境变量:

变量 默认值 描述
MACMINI_HOST 100.102.226.1 Mac mini尾标IP
SSH_KEY_PATH ~/.ssh/macmini SSH私钥路径
TRADE_DB_PATH ~/Public/trading-lab/data/trade.db 远程数据库路径

安装

# Clone repository
git clone https://github.com/locupleto/mcp-trade-db.git
cd mcp-trade-db

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

MCP配置

添加到您的 .mcp.json:

{
  "mcpServers": {
    "trade-db": {
      "type": "stdio",
      "command": "/path/to/mcp-trade-db/venv/bin/python3",
      "args": ["/path/to/mcp-trade-db/trade_db_mcp_server.py"],
      "env": {
        "MACMINI_HOST": "100.102.226.1",
        "SSH_KEY_PATH": "/Users/urban/.ssh/macmini",
        "TRADE_DB_PATH": "~/Public/trading-lab/data/trade.db"
      }
    }
  }
}

使用示例

# Get portfolio summary
mcp__trade-db__get_portfolio_summary(timing_mode="aggressive")

# List open positions
mcp__trade-db__get_open_positions(timing_mode="both", executed_only=true)

# Check recent trades
mcp__trade-db__get_recent_trades(days=7, limit=20)

# Get details for specific symbol
mcp__trade-db__get_position_details(symbol="AAPL")

定时模式

交易数据库跟踪两种执行时间策略:

  • 保守的 (T+1 Open):收到信号后,在第二天开放时进入
  • 激进的 (Same-day Close):在信号日收盘时进入

大多数工具都接受 timing_mode 参数: "conservative", "aggressive",或 "both".

需求

  • Python 3.10+
  • 使用密钥身份验证通过SSH访问Mac mini
  • mcp Python包

许可证

麻省理工学院