内容
# 交易工具
独立的MCP服务器，包含用于量化交易的市场数据工具 — 开高低收量（OHLCV）、基本面数据、新闻、情绪和宏观经济数据。
## 工具列表
| 工具 | 描述 |
|------|-------------|
| `股票概况` | 公司概况（名称、行业、市场资本、描述） |
| `交易品种上下文` | 交易品种身份、交易量大小、交易所元数据 |
| `财务报表` | 损益表、资产负债表、现金流量表 |
| `行业信息` | 行业/产业分类和指标 |
| `市场数据` | 历史开高低收量数据，附带技术指标 |
| `技术指标` | EMA、RSI、MACD、布林带、ATR等 |
| `市场快照` | 实时市场概况（指数、 breadth） |
| `公司新闻` | 公司特定新闻源 |
| `全球新闻` | 宏观经济和市场范围内的新闻 |
| `社会情绪` | StockTwits / Reddit / Futu 社会情绪 |
| `FRED数据` | FRED 经济数据系列 |
| `预测市场` | Polymarket 预测市场数据 |
## 快速开始
### 安装
```bash
# 从源码（开发环境）
pip install -e ".[futu]"
# 或通过 uvx
uvx --from . 交易工具-mcp
```
### MCP 客户端配置（Cursor / Claude Desktop / Windsurf）
**基础配置（无需 API 密钥）：**
```json
{
"mcpServers": {
"交易工具": {
"command": "uvx",
"args": ["--from", "git+https://github.com/haibingzhao/trading-tools", "交易工具-mcp"]
}
}
}
```
**使用 API 密钥（推荐）：**
```json
{
"mcpServers": {
"交易工具": {
"command": "uvx",
"args": ["--from", "git+https://github.com/haibingzhao/trading-tools", "交易工具-mcp"],
"env": {
"FINNHUB_API_KEY": "您的-finnhub-密钥",
"FRED_API_KEY": "您的-fred-密钥",
"ALPHA_VANTAGE_API_KEY": "您的-alphavantage-密钥"
}
}
}
}
```
> API 密钥是可选的。如果未设置密钥，工具将回退到不需要密钥的来源。
## 数据来源
| 来源 | 覆盖范围 | 需要 API 密钥 |
|--------|----------|------------------|
| 雅虎财经 | 美国，香港，加密货币 | 否 |
| Finnhub | 全球新闻，公司新闻 | [是（免费层）](https://finnhub.io/register) |
| FRED | 美国宏观经济数据 | [是（免费层）](https://fred.stlouisfed.org/docs/api/api_key.html) |
| AlphaVantage | 全球新闻，基本面数据 | [是（免费层）](https://www.alphavantage.co/support/#api-key) |
| Futu OpenD | 香港，A股（实时） | 否（本地守护进程） |
| Polymarket | 预测市场 | 否 |
| StockTwits | 美国社会情绪 | 否 |
### 环境变量
创建 `.env` 文件或设置环境变量：
```bash
# 可选 — 启用额外数据源
FINNHUB_API_KEY=
FRED_API_KEY=
ALPHA_VANTAGE_API_KEY=
# Futu OpenD（香港 / A股数据）
FUTU_HOST=127.0.0.1
FUTU_PORT=11111
```
## 需求
- Python >= 3.10
- 依赖项：fastmcp，pandas，stockstats，requests
## 许可证
MIT
