finai-research / rules

---
description: MCP数据工具配置与使用指南
description_en: MCP data tools configuration and usage guide — all 43 servers with tool examples
alwaysApply: true
---

# MCP工具配置与使用指南

## 快速导航

| 你想要... | 使用这个工具 |
|---|---|
| 搜学术论文（全文） | `user-openalex`、`user-arxiv`、`user-context7`、`user-semantic-scholar` |
| 查A股行情/财务 | `user-tushare`（需Token）或 akshare（免费备选） |
| 查A股财务（免费） | `user-yfinance`（中概股/港股ADR） |
| 查宏观指标（GDP/CPI/M2） | `user-financial`（免费akshare+WorldBank） |
| 查美国国债收益率/经济日历 | `user-eodhd`（需Key）或 `user-fed-data`（免费） |
| 读研报、看新闻、找分析师 | `user-eastmoney-reports`（免费） |
| 查外汇/大宗商品/航运 | `user-enhanced-finance`（免费） |
| SEC年报/10-K/8-K | `user-sec-edgar`（免费） |
| 美股行情/财务/期权/ETF | `user-yfinance`（免费） |
| 网络搜索（中英文） | `user-brave-search`（需Key）或 WebSearch |
| 中国省级/市级统计 | `user-province-stats`、`user-hubei-stats` |

**核心原则：每个数据需求都有四层fallback，确保任何情况下都能获取数据。**

---

## MCP服务概览（43个目录服务器）

### 学术文献（5个）

| 服务 | 功能 | API Key |
|---|---|---|
| `user-openalex` | OpenAlex论文元数据（2亿+，免费） | 无需 |
| `user-arxiv` | ArXiv论文搜索（免费） | 无需 |
| `user-context7` | 论文全文索引（免费） | 无需 |
| `user-semantic-scholar` | Semantic Scholar（需Key可选） | 免费层够用 |
| `user-nber-wp` | NBER工作论文（免费） | 无需 |

### A股数据（4个）

| 服务 | 功能 | API Key | 免费备选 |
|---|---|---|---|
| `user-tushare` | A股财务/行情/融资融券 | TUSHARE_TOKEN | akshare / baostock |
| `user-eastmoney-reports` | 研报/新闻/概念/分析师 | 无需 | — |
| `user-wind` | Wind数据 | 无Key（需Wind账号） | akshare |
| `user-csmar` | CSMAR国泰安 | CSMAR_API_KEY（机构） | akshare |

### 美股/全球市场（3个）

| 服务 | 功能 | API Key |
|---|---|---|
| `user-yfinance` | 美股/港股行情/财务/期权/ETF | 无需 |
| `user-sec-edgar` | SEC 10-K/10-Q/8-K公告 | 无需 |
| `user-enhanced-finance` | 外汇/航运指数/白银/期货 | 无需 |

### 宏观经济（10个）

| 服务 | 功能 | API Key |
|---|---|---|
| `user-financial` | 中国宏观（GDP/CPI/M2/EPU，akshare+WorldBank） | 无需 |
| `user-eodhd` | 国债收益率/经济日历 | EODHD_API_KEY |
| `user-fed-data` | 美联储/FOMC数据 | 无需 |
| `user-wb-data` | 世界银行宏观指标 | 无需 |
| `user-imf-data` | IMF世界经济展望 | 无需 |
| `user-oecd-data` | OECD经济数据 | 无需 |
| `user-bea-data` | 美国经济分析局GDP | 无需 |
| `user-macro-ceic` | CEIC中国宏观 | 无需 |
| `user-macro-datas` | 宏观数据聚合 | 无需 |
| `user-macro-stats` | 宏观统计 | 无需 |

### 工具类（10个）

| 服务 | 功能 |
|---|---|
| `user-brave-search` | 网络搜索（中英文，需Key） | BRAVE_SEARCH_API_KEY |
| `user-latex-mcp` | LaTeX排版检查 |
| `user-pandas-mcp` | 数据处理（pandas） |
| `user-playwright-mcp` | 浏览器自动化 |
| `user-e2b-mcp` | 云端代码执行 |
| `user-filesystem-mcp` | 文件系统操作 |
| `user-province-stats` | 中国省级统计 |
| `user-hubei-stats` | 湖北省统计 |
| `user-wuhan-stats` | 武汉市统计 |
| `user-cryptocompare` | 加密货币（BTC/ETH等） |
| `user-newsapi` | 全球财经新闻（需Key） |
| `user-eastmoney-fund` | 公募基金数据 |
| `user-eastmoney-bond` | 债券数据 |
| `user-eastmoney-option` | 期权数据 |

### 美股数据（user-yfinance）

```
server: user-yfinance
tool: get_yf_quote
params: { "ticker": "AAPL" }

server: user-yfinance
tool: get_yf_historical
params: { "ticker": "MSFT", "start_date": "2024-01-01", "end_date": "2024-12-31" }

server: user-yfinance
tool: get_yf_financials
params: { "ticker": "GOOGL" }

server: user-yfinance
tool: get_yf_etf_holdings
params: { "ticker": "SPY" }

server: user-yfinance
tool: get_yf_options
params: { "ticker": "SPY" }
```
**无需API Key**，直接使用 Yahoo Finance。

### SEC EDGAR（user-sec-edgar）

```
server: user-sec-edgar
tool: get_sec_cik_by_ticker
params: { "ticker": "AAPL" }

server: user-sec-edgar
tool: get_sec_10k
params: { "cik": "0000320183", "year": 2024 }

server: user-sec-edgar
tool: get_sec_8k
params: { "cik": "0000320183", "limit": 10 }
```
**无需API Key**，SEC数据完全免费公开。

### OpenAlex（user-openalex）

```
server: user-openalex
tool: get_openalex_works
params: { "query": "carbon trading innovation policy", "per_page": 25 }

server: user-openalex
tool: get_openalex_authors
params: { "author_id": "A123456789" }
```
**无需API Key**，2亿+学术成果。

### Context7（user-context7）

```
server: user-context7
tool: get_context7_by_arxiv
params: { "arxiv_id": "2301.12345" }

server: user-context7
tool: get_context7_by_query
params: { "query": "digital finance fintech", "max_results": 10 }

server: user-context7
tool: get_context7_by_doi
params: { "doi": "10.1000/xyz123" }
```
**无需API Key**，论文全文获取。

### CryptoCompare（user-cryptocompare）

```
server: user-cryptocompare
tool: get_cc_price
params: { "symbol": "BTC" }

server: user-cryptocompare
tool: get_cc_historical
params: { "symbol": "ETH", "start_date": "2024-01-01", "end_date": "2024-12-31" }

server: user-cryptocompare
tool: get_cc_top_coins
params: { "limit": 20 }
```
**无需API Key**，免费tier足够研究使用。

### NewsAPI（user-newsapi）

```
server: user-newsapi
tool: get_news_search
params: { "query": "Federal Reserve interest rate", "language": "en" }

server: user-newsapi
tool: get_news_top_headlines
params: { "category": "business", "country": "us" }
```
需要 `NEWSAPI_API_KEY`（免费注册：https://newsapi.org/register）

## 宏观数据（MCP）

### 1. 全球宏观指标（user-financial / World Bank API）

```
server: user-financial
tool: get_wb_indicator
params: { "country_code": "USA", "indicator": "wb_gdp_usd" }
```

覆盖：全球所有国家，指标包括GDP/CPI/人口/贸易/债务。
**无需API Key**，直接调用 World Bank API。

### 2. 中国宏观指标（user-financial / akshare）

```
server: user-financial
tool: get_macro_china
params: { "indicator": "cpi" }
```

可用指标：cpi, ppi, gdp, pmi, m2, fdi, retail, lpr, shibor, new_financial_credit
**无需API Key**，akshare 本地缓存数据。

### 3. 英国/日本/德国/澳大利亚/加拿大宏观（user-financial）

```
server: user-financial
tool: get_macro_uk
params: { "indicator": "cpi" }

server: user-financial
tool: get_macro_japan
params: { "indicator": "unemployment_rate" }
```

**无需API Key**。

### 4. 美国国债收益率曲线（user-eodhd）

```
server: user-eodhd
tool: get_ust_yield_rates
params: { "year": 2024 }
```

### 5. 经济日历（user-eodhd）

```
server: user-eodhd
tool: get_economic_events
params: { "country": "US", "limit": 200 }
```

## A股数据

### 1. A股行情/财务/资金流（user-tushare）

```
server: user-tushare
tool: get_daily_quote
params: { "ts_code": "000001.SZ", "start_date": "20240101", "end_date": "20241231" }

server: user-tushare
tool: get_financial_report
params: { "ts_code": "000001.SZ", "report_type": "income" }

server: user-tushare
tool: get_margin_data
params: { "data_type": "hsgt" }
```

需要 `TUSHARE_TOKEN` 环境变量（https://tushare.pro/register）

## 研报与新闻（user-eastmoney-reports）

```
server: user-eastmoney-reports
tool: get_research_report
params: { "ts_code": "000001.SZ", "max_results": 20 }

server: user-eastmoney-reports
tool: get_board_concept
params: { "data_type": "spot" }

server: user-eastmoney-reports
tool: get_board_industry
params: { "industry_code": "884856" }

server: user-eastmoney-reports
tool: get_stock_news
params: { "ts_code": "000001.SZ", "limit": 20 }

server: user-eastmoney-reports
tool: get_analyst_rank
params: { "year": 2024 }
```

## 外汇/大宗商品/航运（user-enhanced-finance）

```
server: user-enhanced-finance
tool: get_forex_spot
params: {}

server: user-enhanced-finance
tool: get_forex_hist
params: { "currency_pair": "USD/CNY", "start_date": "20240101", "end_date": "20241231" }

server: user-enhanced-finance
tool: get_shipping_index
params: { "index_name": "bdi" }

server: user-enhanced-finance
tool: get_commodity_price
params: { "commodity": "silver" }
```

## 文献检索

### 1. 网络搜索

```
server: user-brave-search
tool: brave_web_search
params: { "query": "碳排放权交易 绿色创新 DID 双重差分" }
```

### 2. 学术论文

```
server: user-arxiv
tool: semantic_search
params: { "query": "carbon trading innovation policy effect" }
```



## 数据获取优先级

1. **优先使用MCP** → 实时数据，无需手动下载
2. **外部数据文件** → 放入 `data/` 目录
3. **模拟数据** → 仅用于演示，需用户确认

## 数据目录结构

```
论文-研报工作流/
├── data/ # 外部数据输入目录
├── papers/ # 论文输出目录
├── scripts/ # 分析脚本
│ └── research_framework/ # 通用研究框架
└── mcp_servers/ # 自定义MCP服务器
```