AI导哈

股票交易代理服务器

一个允许通过Claude Code/Desktop使用自然语言进行股票分析、回测和交易模拟的MCP服务器。

  • by KULEEEE
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 KULEEEE/Trading-Agent

使用说明

交易代理MCP服务器

在Claude Code/Desktop中，可以用自然语言进行股票分析、后台测试和交易模拟的MCP服务器。

工作原理

사용자 <-> Claude Code/Desktop <-> MCP 프로토콜 <-> Trading Agent 서버 <-> Yahoo Finance API

MCP（模型上下文协议） 是允许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.txt

Mac/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/Linux python.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许可证

相关 MCP