内容
<p align="center">
<img src="brand/social-preview.png" alt="equivault-mcp — AI-powered equity research for Claude" width="100%"/>
</p>
<h1 align="center">equivault-mcp</h1>
<p align="center">
MCP 服务器，用于 <a href="https://equivault.ai">EquiVault</a> — 面向 Claude 的 AI 驱动的股票研究工具。
</p>
<p align="center">
<a href="https://www.npmjs.com/package/equivault-mcp"><img src="https://img.shields.io/npm/v/equivault-mcp?color=F59E0B&labelColor=0F172A" alt="npm"/></a>
<a href="https://github.com/equivault/equivault-mcp/actions"><img src="https://img.shields.io/github/actions/workflow/status/equivault/equivault-mcp/ci.yml?branch=main&labelColor=0F172A" alt="CI"/></a>
<a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-8B5CF6?labelColor=0F172A" alt="license"/></a>
</p>
## 快速入门
### Claude 桌面版
将以下内容添加到 `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"equivault": {
"command": "npx",
"args": ["-y", "equivault-mcp"],
"env": {
"EQUIVAULT_API_KEY": "your-api-key",
"EQUIVAULT_TENANT_ID": "your-tenant-id"
}
}
}
}
```
### Claude 代码
```bash
claude mcp add equivault -- npx -y equivault-mcp
```
然后设置您的凭证：
```bash
export EQUIVAULT_API_KEY=your-api-key
export EQUIVAULT_TENANT_ID=your-tenant-id
```
## 配置
| 变量 | 必需 | 默认值 | 描述 |
|---|---|---|---|
| `EQUIVAULT_API_KEY` | 是 | — | 您的 EquiVault API 密钥 |
| `EQUIVAULT_TENANT_ID` | 是 | — | 您的 EquiVault 租户 ID |
| `EQUIVAULT_BASE_URL` | 否 | `https://api.equivault.ai/api/v1` | API 基本 URL（用于自托管） |
## 工具
### 核心研究（M1）
| 工具 | 描述 |
|------|-------------|
| `search_companies` | 按名称、股票代码或关键词搜索公司 |
| `get_company` | 获取详细的公司简介 |
| `get_financials` | 获取财务报表（收入表、资产负债表、现金流量表） |
| `get_metrics` | 获取财务比率和指标时间序列 |
| `get_stock_quote` | 获取当前股票价格、涨跌幅和交易量 |
| `screen_companies` | 按财务标准筛选公司 |
| `compare_companies` | 并排比较同行公司 |
| `get_billing_status` | 查看订阅层级和 API 使用情况 |
### 公司深度数据（M2）
| 工具 | 描述 | 层级 |
|------|-------------|------|
| `get_company_narrative` | 投资理由、驱动因素、阻力、风力 | Starter+ |
| `get_guidance` | 管理层指导跟踪器，包含业绩结果 | Professional+ |
| `get_segments` | 按业务板块划分的收入和营业收入 | Professional+ |
| `get_capital_allocation` | 股票回购、分红、债务、并购、资本支出历史 | Professional+ |
| `get_risk_factors` | 从文件中提取的风险因素演变 | Professional+ |
| `get_insider_transactions` | 内幕交易买卖，10b5-1 标志 | Advisor+ |
| `get_earnings_quality` | 应计、现金转换、非 GAAP 标志 | Professional+ |
| `get_debt_maturities` | 债务到期计划 | Professional+ |
| `get_competitive_signals` | 市场份额、新进入者、价格信号 | Professional+ |
| `get_management_statements` |值得注意的管理层声明及其情绪 | Advisor+ |
| `get_accounting_snapshots` | 会计政策和期间变化 | Professional+ |
| `get_strategy_profiles` | 可用的投资策略配置文件 | All |
### 综合（M2）
| 工具 | 描述 |
|------|-------------|
| `analyze_company` | 一键式：公司简介 + 财务数据 + 指标 + 叙述 |
| `company_deep_dive` | `analyze_company` 中的所有内容 + 10 个配置文件章节 |
### 信号与提醒（M3）
| 工具 | 描述 | 层级 |
|------|-------------|------|
| `get_signals` | 单个公司的分页信号 | Analyst+ |
| `get_signal_summary` | 按类型/严重程度分类的计数 + 未读计数 | Analyst+ |
| `get_signal_dashboard` | 投资组合范围的信号概览 | Analyst+ |
| `get_signal_trends` | 投资组合的时间分段活动 | Analyst+ |
| `get_trending_signals` | 当前跨公司趋势信号 | Analyst+ |
| `create_alert` | 创建提醒规则 | Advisor+ |
| `update_alert` | 更新提醒规则 | Advisor+ |
| `delete_alert` | 删除提醒规则 | Advisor+ |
### 简报、投资组合和媒体（M3）
| 工具 | 描述 | 层级 |
|------|-------------|------|
| `list_briefs` | 列表投资简报（按公司或关注筛选） | Starter+ |
| `get_brief` | 完整的简报内容与记分卡 | Starter+ |
| `get_portfolio_analytics` | 收益、夏普比率、板块配置、赢家/输家 | Analyst+ |
| `list_media` | 财报电话会议、播客、演示文稿、新闻稿 | Starter+ |
| `get_guru_holdings` | 杰出投资者投资组合持仓与变动 | Analyst+ |
| `get_markets` | 可用市场（代码、国家、货币、MIC） | All |
### 高级综合（M3）
| 工具 | 描述 |
|------|-------------|
| `morning_briefing` | 信号仪表盘 + 趋势 + 简报 + 可选投资组合 — 集成在一个调用中 |
| `research_report` | `company_deep_dive` + 最新信号 + 相关简报，准备好渲染 |
## 示例
**研究一家公司：**
> “苹果的最新年度财务报表和关键指标是什么？”
**筛选机会：**
> “找出市值超过 100 亿美元且市盈率低于 20 的科技公司。”
**比较竞争对手：**
> “比较微软、谷歌和亚马逊的收入增长和利润率。”
**查看账户状态：**
> “这个月我还剩多少查询次数？”
## 文档
- **[EXAMPLES.md](./EXAMPLES.md)** — 每类别工具的实际 Claude 提示
- **[docs/ALIGNMENT.md](./docs/ALIGNMENT.md)** — MCP 如何与平台 API 版本保持同步
- **[CHANGELOG.md](./CHANGELOG.md)** — 按版本发布的更新日志
- **[CONTRIBUTING.md](./CONTRIBUTING.md)** — 开发工作流和约定
## 开发
```bash
# 克隆并安装
git clone https://github.com/equivault/equivault-mcp
cd equivault-mcp
npm install
# 构建
npm run build
# 运行测试
npm test
# 类型检查
npm run typecheck
# 监视模式（开发）
npm run dev
```
## 许可证
MIT
