交易代理MCP服务器
在Claude Code/Desktop中,可以用自然语言进行股票分析、后台测试和交易模拟的MCP服务器。
工作原理
사용자 Claude Code/Desktop MCP 프로토콜 Trading Agent 서버 Yahoo Finance APIMCP(模型上下文协议) 是允许Claude使用外部工具的协议。 该项目作为MCP服务器运行,允许Claude调用用于获取和分析股票数据的工具。
项目结构
Trading-Agent/
├── mcp_server.py # MCP 서버 진입점 (Claude와 통신)
├── src/
│ ├── agent/ # 트레이딩 에이전트 코어
│ ├── api/ # Yahoo Finance API 클라이언트
│ ├── backtest/ # 백테스팅 엔진
│ ├── indicators/ # 기술적/펀더멘털 지표 계산
│ ├── strategies/ # 트레이딩 전략 (MA Crossover, RSI)
│ ├── risk/ # 리스크 관리
│ ├── data/ # 데이터 관리 및 DB
│ ├── monitoring/ # 모니터링
│ └── utils/ # 설정, 로거
├── requirements.txt # Python 핵심 의존성
├── requirements-mcp.txt # MCP 서버 의존성
├── .env.example # 환경변수 템플릿
├── Dockerfile # Docker 배포용
└── docker-compose.yml # Docker Compose 설정提供的功能
| 工具 | 说明 |
|---|---|
analyze_stock | 技术分析(RSI、MACD、博林杰乐队、交易信号) |
analyze_fundamentals | 基本面分析(PER、PBR、ROE、分红等) |
compare_fundamentals | 多个项目基本面比较 |
backtest_stock | 单项后测试 |
backtest_multiple | 多项目后台测试比较 |
simulate_trading | 交易模拟 |
get_portfolio_status | 查看产品组合现状 |
安装方法
前提条件
- Python 3.11+
- 克劳德代码 或者 克劳德桌面版
步骤1:下载项目
git clone https://github.com/KULEEEE/Trading-Agent.git
cd Trading-Agent步骤2:创建虚拟环境并安装依赖性
窗户:
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements-mcp.txtMac/Linux:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-mcp.txt步骤3:设置环境变量
cp .env.example .env.env 打开文件修改所需设置(默认情况下也可以):
DEFAULT_SYMBOLS=AAPL,GOOGL,MSFT,TSLA # 기본 종목
INITIAL_CAPITAL=100000 # 초기 자본금
STOP_LOSS_PCT=0.05 # 손절 비율 (5%)
TAKE_PROFIT_PCT=0.15 # 익절 비율 (15%)步骤4:连接MCP服务器
在Claude Code或Claude Desktop中注册MCP服务器。
使用Claude Code时
在项目根目录中 .mcp.json 创建文件:
{
"mcpServers": {
"trading-agent": {
"type": "stdio",
"command": "/.venv/Scripts/python.exe",
"args": ["/mcp_server.py"],
"env": {
"PYTHONPATH": "",
"PYTHONUTF8": "1"
}
}
}
}`请改为实际的绝对路径。 Mac/Linuxpython.exe但是。.venv/bin/python`使用。
使用Claude Desktop
打开并修改配置文件:
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json - 雨衣:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"trading-agent": {
"command": "python",
"args": ["/mcp_server.py"],
"env": {
"PYTHONPATH": ""
}
}
}
}步骤5:重新启动
重新启动Claude Code或Claude Desktop时,可以使用Trading Agent工具。
使用示例
用自然语言对Claude说:
"애플 주식 기술적 분석해줘"
"삼성전자 하이닉스 펀더멘털 비교해줘"
"NVDA를 MA Crossover 전략으로 1년간 백테스트해줘"
"TSLA로 30일 트레이딩 시뮬레이션 해봐"
"AAPL, GOOGL, MSFT 비교 백테스팅 해줘"支持战略
| 策略 | 关键字 | 说明 |
|---|---|---|
| MA交叉 | ma_crossover | 短期(20天)/长期(50天)移动平均线交叉时买卖 |
| RSI | rsi 收购RSI 30以下,抛售70以上 |
作为Docker运行(可选)
cp .env.example .env
docker-compose up --build故障排除
| 症状 | 解决方法 |
|---|---|
| 无法连接MCP服务器 | .mcp.json验证的路径是否正确,python路径是否为虚拟环境中的路径 |
| 找不到工具 | pip install -r requirements-mcp.txt 重新运行 |
| 打破韩文 | env呃 "PYTHONUTF8": "1" 添加 |
| 无数据 | 检查互联网连接,确认Yahoo Finance是否可访问 |
日志 logs/ 可以在目录中查看。
许可证
MIT许可证
