内容
Quantitative MCP
一个适用于 [Quiver Quantitative](https://www.quiverquant.com/) 替代数据[模型上下文协议://modelcontextprotocol.io)(MCP)服务器,基于 [FastM://github.com/jlowin/fastmcp) 构建。
它提供了16种工具,涵盖国会交易、SEC表格4内幕交易、政府合同、游说、r/WallStreetBets活动、场外暗池)量和13。
> **请勿作为。** 数据用于研究和## 身份验证
Quiver牌头:: Token <>`。
一些目前是**开放(无需令牌);大多数数据集****:
| 工具 | 数据令牌------|---------|:|
| `congress_tr` | 国会近期交易成员) | — |
|gress_trading_by_ticker 单个股票的国会 — |
| `insider_trading_recent` | SEC表格4实时数据流(所有股票) | — |
| `insider_trading_by_ticker` | 单个股票的表格4 | ✅ |
| `gov_contracts_recent` / `_by_ticker` | 美国政府合同授予 | ✅ |
| `lobbying_recent` / `_by_ticker` | 企业游说披露 | ✅ |
| `wallstreetbets_recent` / `_by` | r/WBets提及活动 || `offexchange_recent`by_ticker` | 场外交易/暗池做空 ✅ |
| `sec13_recent` | 13F机构持仓变化 | ✅ |
|_trading_recent` | 美国院交易 | ✅ |
|ate_trading_recent` |议院交易 | ✅ |
quiver_status` | 牌状态 + 哪些开放的 | — |
需要的工具在未配置密钥清晰的“设置QUIVER”消息,因此开放的数据集使用。在 <https://www.quiverquant.com/> 获取密钥。
##```bash
cd-quant-mcp
pythonm venv .venv
source/bin/activate
pip install -r requirements.txt
cp .envenv # 然后编辑 .env 并粘贴您的令牌
🍏 **Apple Silicon 注意:** 使用虚拟环境的 ` 安装(如下),**而不是etta/x86_64 `uv`,否则可能导致 `pydantic-core` 等本地轮失败,出现“架构不错误。
在 `.env`您的令牌:
```
QUIVER_API_TOKEN=your_token
```
它也可以通过 [`://github.com/astr/uv) 无依赖运行于内联 [PEP https://peps.python.org/0723/) 元```bash
uv run_quant_mcp.py
```
## Claude Desktop 配置
添加到 `claude_desktop_config.json` 中**路径。服务器从 `.env` 读取令牌,因此 `env` 块可以:
```json
{
"m": {
iver-quant": {
command": "/absolute/path/to-quant-mcp/.venv "args": ["/absolute/path/to/quiver-quant-mcp/quiver_quant_m"],
"env": {}
}
}
```
重启 Claude## 使用示例
- “国会交易?”→ `congress_trading_recent`
-我在NVDA的所有国会交易。”→ `congress_tr_ticker`
- “最近有人在TSLA买入吗?”→ `insider_trading_by_ticker`(需要令牌)
- “哪些公司刚刚获得政府合同?”→ `gov_contracts_recent`(需要令牌)
- “WallStreetBets上有什么热门?”→ `wallstreetbets_recent`(需要令牌)
- “我的令牌是否设置正确?”→ `quiver_status`
## 测试
```bash
python test_quiver.py
```
离线测试涵盖结果修剪助手、身份验证头构造(有/无令牌)、令牌提示消息、`quiver_status` 和工具注册。无需网络。
开放的端点(`congress_trading_recent`、`congress_trading_by_ticker`、`insider_trading_recent`)可以使用,无需令牌。
## 注意
- **`limit`** (1-1000,默认100)在客户端修剪结果;每个工具还报告 `total`。
- **`insider_trading_recent`** 是一个大数据流 - 优先使用 `insider_trading_by_ticker` (令或小 `limit` 进行目标工作。
- 一些Quiver数据集在其他地方公开(每股13F、维浏览量、“雷达”峰值)被故意省略API路径无法确认;仅连接已验证的端点。
- 请尊重Quiver Quantitative的API条款和速率限制。
## 致谢
数据:[Quiver Quantitative](https://www.quiverquant.com/)。这是独立的Python/FastMCP客户端,与Quiver Quantitative无关或未得到其认可。
## 许可证
MIT — 请参阅 `LICENSE`(如果包含)。Quiver数据仍受Quiver的使用条款约束。