内容
# ROIC.ai 金融数据 MCP 服务器
[](https://www.npmjs.com/package/@roicai/mcp-server)
[](./LICENSE)
[](https://modelcontextprotocol.io)
**一个金融数据 MCP 服务器和股票市场 MCP 服务器。** 它将 AI 助手（Claude、ChatGPT、Cursor、VS Code 和 OpenAI Codex）连接到超过 60,000 家上市公司的股票价格、财务报表、收益电话会议记录、基本面数据、比率和估值数据，通过 [Model Context Protocol (MCP)](https://modelcontextprotocol.io)。
一个服务器为您提供 **财务报表 MCP**、**收益 MCP** 和 **基本面数据 MCP**。用自然语言提问，模型实时获取股票市场数据，无需复制粘贴。
> 由 [ROIC.ai](https://www.roic.ai) 提供支持 — 全球 70 多个交易所的上市公司财务报表、比率、估值倍数和收益电话会议记录。
它是 **开源** 的，可以免费在此 GitHub 仓库中运行：带有一个免费的 API 密钥，您就可以拥有一个金融 MCP 服务器和一个股票价格 MCP 服务器。与单一来源的馈送（如 Yahoo Finance）不同，ROIC.ai 提供标准化的财务报表、预计算的比率和估值倍数，涵盖 70 多个交易所，因此模型可以获得干净、可比较的数字，而不是爬取的表格。
---
## 主机版本（推荐）
使用 ROIC.ai 的 **主机 MCP 服务器** 最快：`https://mcp.roic.ai/mcp` — 流式 HTTP，带有 OAuth 登录，因此无需管理 API 密钥，它会自动更新。与 ChatGPT、Claude、Cursor、VS Code 和 Codex 兼容。
Claude 代码：
```bash
claude mcp add --transport http roicai https://mcp.roic.ai/mcp
```
任何接受基于 URL 的 MCP 服务器的客户端：
```json
{
"mcpServers": {
"roicai": {
"url": "https://mcp.roic.ai/mcp",
"transport": "http"
}
}
}
```
完整的客户端设置指南（ChatGPT、Claude、Cursor、VS Code、Codex）：[roic.ai/api/mcp](https://www.roic.ai/api/mcp)。
## 自托管（开源）
更喜欢自己运行并带有 API 密钥？此仓库是开源服务器。在 **https://www.roic.ai/dashboard** 获取免费 API 密钥，然后直接使用 `npx` 运行（无需安装）：
```bash
ROIC_API_KEY=your_key npx @roicai/mcp-server
```
### Claude 桌面 / Cursor
将以下内容添加到您的 MCP 配置文件（`claude_desktop_config.json` for Claude Desktop, `.cursor/mcp.json` for Cursor）：
```json
{
"mcpServers": {
"roicai": {
"command": "npx",
"args": ["-y", "@roicai/mcp-server"],
"env": { "ROIC_API_KEY": "your_key_here" }
}
}
}
```
### Claude 代码（CLI）
```bash
claude mcp add roicai --env ROIC_API_KEY=your_key -- npx -y @roicai/mcp-server
```
### VS 代码
将以下内容添加到 `.vscode/mcp.json`：
```json
{
"servers": {
"roicai": {
"command": "npx",
"args": ["-y", "@roicai/mcp-server"],
"env": { "ROIC_API_KEY": "your_key_here" }
}
}
}
```
### OpenAI Codex
将以下内容添加到 `~/.codex/config.toml`：
```toml
[mcp_servers.roicai]
command = "npx"
args = ["-y", "@roicai/mcp-server"]
env = { ROIC_API_KEY = "your_key_here" }
```
重启您的客户端并询问：_“使用 roicai 显示 Apple 最近 3 年的损益表。”_
---
## 您获得的内容
此股票市场 MCP 服务器公开了 **25 个只读工具**，涵盖七个类别：
- **财务报表** — 损益表、资产负债表、现金流量表（年度或季度）。
- **财务比率** — 盈利能力（ROE、ROA、ROIC、利润率）、信用/债务、流动性、工作资本、收益率。
- **估值** — 市盈率、市净率、市销率、EV/EBITDA 及其他倍数、企业价值、每股数据。
- **收益电话会议** — 按年份和季度划分的完整收益电话会议记录。
- **股票价格** — 实时和历史 OHLCV，带有日期范围（一个独立的股票价格 MCP 服务器）。
- **公司数据** — 公司简介（CEO、行业、员工）和新闻。
- **发现** — 搜索和列出股票代码、交易所、行业、国家。
## 工具
| 工具 | 返回内容 |
| --- | --- |
| `search_tickers` | 按股票代码或公司名称搜索股票代码 |
| `list_tickers` | 列出股票代码（按交易所/上市状态筛选） |
| `search_ticker_by_identifier` | 通过 CIK、CUSIP 或 ISIN 解析股票代码 |
| `list_exchanges` | 所有股票交易所及其股票代码数量 |
| `list_sectors` | 所有市场板块及其股票代码数量 |
| `list_industries` | 所有行业及其股票代码数量 |
| `list_countries` | 所有国家及其股票代码数量 |
| `get_company_profile` | 公司简介、CEO、员工、行业 |
| `get_company_news` | 最近的新闻文章，分页和日期筛选 |
| `get_latest_earnings_call` | 最近的收益电话会议记录 |
| `list_earnings_calls` | 可用的收益电话会议（年份、季度、日期） |
| `get_earnings_call_transcript` | 按年份和季度获取特定记录 |
| `get_stock_prices` | 历史 OHLCV 股票价格，带有日期范围 |
| `get_latest_stock_price` | 最近的股票价格 |
| `get_income_statement` | 收入、毛利润、净利润、EPS、EBITDA、利润率 |
| `get_balance_sheet` | 资产、负债、债务、权益、流通股 |
| `get_cash_flow` | 经营/投资/融资现金流、资本支出、自由现金流 |
| `get_profitability_ratios` | ROE、ROA、ROIC、利润率、税率、派息 |
| `get_credit_ratios` | 债务/EBITDA、债务/权益、利息覆盖 |
| `get_liquidity_ratios` | 流动比率、速动比率、现金比率、Altman Z-Score |
| `get_working_capital_ratios` | 周转率、天数、现金转换周期 |
| `get_yield_analysis` | FCF 收益率、股东收益率、资本收益率 |
| `get_enterprise_value` | 市值、EV、EV/销售额、EV/EBITDA |
| `get_valuation_multiples` | 市盈率、市净率、市销率、市现率、EV 倍数 |
| `get_per_share_data` | EPS、收入、账面价值、每股现金流 |
每个工具都接受一个公司 `identifier`，可以是 **股票代码**（例如 `AAPL`）、**CIK**、**CUSIP** 或 **ISIN**。财务工具接受 `period`（`annual` 或 `quarterly`）、`limit`、`order` 和日期/财政年度过滤器。
## 示例提示
```text
比较微软和谷歌在过去 3 年的盈利能力（利润率和 ROE）。
特斯拉是否被高估？显示其市盈率、EV/EBITDA 和市销率与过去 5 年的比较。
苹果管理层在最新的收益电话会议中对 AI 说了什么？
显示亚马逊 2025 年 1 月的每日股票价格。
哪些行业拥有最多的上市公司？
```
## 身份验证
服务器使用传递给 `ROIC_API_KEY` 环境变量的 API 密钥向 ROIC.ai REST API 进行身份验证。从您的 [ROIC.ai 仪表板](https://www.roic.ai/dashboard) 获取免费密钥。免费层涵盖所有工具，适用于所有上市公司；付费计划提高速率限制和历史深度。参见 [定价](https://roic.ai/pricing)。
## 配置
| 变量 | 默认值 | 描述 |
| --- | --- | --- |
| `ROIC_API_KEY` | （必填） | 您的 ROIC.ai REST API 密钥 |
| `ROIC_API_BASE` | `https://api.roic.ai/v2` | 覆盖 API 基本 URL |
## 本地开发
```bash
git clone https://github.com/roicai/mcp-server.git
cd mcp-server
npm install
ROIC_API_KEY=your_key npm start
```
需要 Node.js 18+（使用内置的 `fetch`）。
## 链接
- 文档：https://www.roic.ai/api/mcp
- REST API：https://www.roic.ai/api
- 获取 API 密钥：https://www.roic.ai/dashboard
- 模型上下文协议：https://modelcontextprotocol.io
## 许可证
MIT © [ROIC.ai](https://www.roic.ai)
