Trading MCP Server

trading-mcp

交易数据与技术指标的 MCP 服务，基于 uv + pydantic + akshare + TA-Lib 构建。

项目内容

• 提供股票行情数据查询与基础技术指标计算（K 线、RSI、MA、MACD）。
• 提供中长线基本面数据查询（A 股主要指标、美股三大报表、美股主要指标）。
• 统一的市场数据访问层，支持 A 股与美股（如 AAPL.US）。
• MCP 工具化接口，支持 Markdown 或 JSON 输出。

项目架构

• data/：市场数据接入层。MarketDataClient 接口 + AkshareMarketDataClient 实现。
• services/：业务服务层。将原始行情转换为标准结构，并驱动指标计算。
• indicators/：指标引擎封装。基于 TA-Lib 统一调用。
• models/：工具请求与响应模型（Pydantic）。
• utils/：MCP 输出格式化（表格 Markdown 等）。
• mcp_app.py / main.py：MCP 服务入口与工具注册。

目录结构

• config/：配置定义（Pydantic Settings）。
• data/：市场数据客户端实现。
• indicators/：指标计算引擎。
• models/：请求/响应模型。
• services/：业务服务层。
• tests/：单元测试。
• utils/：输出格式化与辅助工具。
• mcp_app.py：MCP 工具注册。
• main.py：服务启动入口。

安装与依赖

1. 安装依赖：

uv sync --extra dev

2. 安装 TA-Lib 系统库：

• macOS: brew install ta-lib
• Debian/Ubuntu: sudo apt-get install libta-lib0 libta-lib0-dev
• Windows: 使用对应 Python 版本的预编译 wheel

配置说明 配置通过环境变量 TRADING_MCP_ 前缀覆盖：

export TRADING_MCP_ENVIRONMENT=dev
export TRADING_MCP_DATA_DIR=./data
export TRADING_MCP_DEFAULT_SYMBOL=000001
export TRADING_MCP_HOST=0.0.0.0
export TRADING_MCP_PORT=8000
export TRADING_MCP_AKSHARE_PROXY_ENABLED=true
export TRADING_MCP_AKSHARE_PROXY_AUTH_IP=10.0.0.8
export TRADING_MCP_AKSHARE_PROXY_AUTH_TOKEN=
export TRADING_MCP_AKSHARE_PROXY_RETRY=30

字段含义：

• TRADING_MCP_ENVIRONMENT：运行环境标识（如 dev / test / prod）。
• TRADING_MCP_DATA_DIR：本地数据目录。
• TRADING_MCP_DEFAULT_SYMBOL：默认行情标的。
• TRADING_MCP_HOST：MCP 服务监听地址。
• TRADING_MCP_PORT：MCP 服务端口。
• TRADING_MCP_AKSHARE_PROXY_ENABLED：是否启用 akshare-proxy-patch。
• TRADING_MCP_AKSHARE_PROXY_AUTH_IP：akshare-proxy-patch 授权网关 IP；未配置时不会安装 patch。
• TRADING_MCP_AKSHARE_PROXY_AUTH_TOKEN：可选授权 token。
• TRADING_MCP_AKSHARE_PROXY_RETRY：patch 内部重试次数。

东财反爬代理说明：

• 项目已内置 akshare-proxy-patch，会在导入 data/akshare_client.py 时自动尝试安装。
• 只有配置了 TRADING_MCP_AKSHARE_PROXY_AUTH_IP 且 TRADING_MCP_AKSHARE_PROXY_ENABLED=true 时才会启用。
• patch 只会 hook 东财相关域名请求，不影响其他非目标站点。

Python 用法

from trading_mcp.config import Settings
from trading_mcp.data import AkshareMarketDataClient
from trading_mcp.indicators import IndicatorEngine

settings = Settings(environment="dev", data_dir="./data", default_symbol="000001")
client = AkshareMarketDataClient()
frame = client.fetch(settings.default_symbol, "2024-01-01", "2024-02-01")

engine = IndicatorEngine()
close_series = frame["close"] if "close" in frame.columns else frame.iloc[:, 0]
result = engine.compute("sma", close_series, timeperiod=5)
print(result.tail())

MCP 服务 启动 MCP 服务（streamable HTTP）：

python main.py

启动 MCP Inspector（适配 WSL，可从宿主机访问）：

./dev.sh

默认会使用以下 Inspector 配置：

• MCP_INSPECTOR_HOST=0.0.0.0
• MCP_INSPECTOR_CLIENT_PORT=6274
• MCP_INSPECTOR_SERVER_PORT=6277
• MCP_INSPECTOR_AUTO_OPEN=false

在 Windows 宿主机浏览器中优先访问：

http://localhost:6274

如本机未启用 WSL localhost 转发，也可以先在 WSL 内执行 hostname -I 查看 IP，再从宿主机访问 http://<wsl-ip>:6274。

如果你只想本机 Linux 环境访问，可覆盖为：

MCP_INSPECTOR_HOST=127.0.0.1 ./dev.sh

注意：Inspector 代理具备启动本地进程的能力。0.0.0.0 仅应在受信任网络环境中使用。

可用工具：

• trading_kline(symbol, limit=30, offset=0, period_type="1d", start_date=None, end_date=None, response_format="markdown")
• trading_macd(symbol, limit=30, fast_period=12, slow_period=26, signal_period=9, offset=0, period_type="1d", start_date=None, end_date=None, response_format="markdown")
• trading_rsi(symbol, limit=30, period=14, offset=0, period_type="1d", start_date=None, end_date=None, response_format="markdown")
• trading_ma(symbol, limit=30, period=20, ma_type="sma", offset=0, period_type="1d", start_date=None, end_date=None, response_format="markdown")
• trading_volume(symbol, limit=30, offset=0, period_type="1d", start_date=None, end_date=None, response_format="markdown")
• trading_fund_flow_individual_em(symbol, limit=30, offset=0, start_date=None, end_date=None, response_format="markdown")
• trading_fund_flow_individual_rank_em(indicator="5日", limit=30, offset=0, response_format="markdown")
• trading_fund_flow_sector_rank_em(indicator="今日", sector_type="行业资金流", sort_by="主力净流入", limit=30, offset=0, response_format="markdown")
• trading_fund_flow_sector_summary_em(symbol, indicator="今日", limit=30, offset=0, response_format="markdown")
• trading_fundamental_cn_indicators(symbol, indicator="按报告期", limit=30, offset=0, start_date=None, end_date=None, response_format="markdown")
• trading_fundamental_us_report(stock, symbol="资产负债表", indicator="年报", limit=30, offset=0, start_date=None, end_date=None, response_format="markdown")
• trading_fundamental_us_indicators(symbol, indicator="年报", limit=30, offset=0, start_date=None, end_date=None, response_format="markdown")
• trading_industry_summary_ths(limit=30, offset=0, response_format="markdown")
• `trading_industry_index_ths(symbol, limit=30, offset=0, start_date=None, end_date=None, res