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.txtMCP配置
添加到您的 .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
mcpPython包
许可证
麻省理工学院