内容
# the13f-mcp
> 适用于 [the13f](https://the13f.com) 的模型上下文协议服务器。将机构13F情报引入Claude Desktop、Cursor、VS Code + Continue，以及任何兼容MCP的主机 — 无需在您这边编写HTTP代码。
## 重要限制
仅限研究数据。数据来源于公开披露的SEC Form 13F文件，相比季度结束日期滞后最多45天。过去的机构定位并不预测未来的表现。这里没有任何内容构成投资建议。每个工具的响应都包含一个`免责声明`字段；主机LLM应将其与生成的任何分析一起显示。
## 安装
```
uvx the13f-mcp
```
或者，如果您更喜欢自己管理Python环境，可以使用 `pip install the13f-mcp`。需要Python 3.11+。
## 获取免费API密钥
免费，无需支付，无需信用卡：
1. 访问 <https://the13f.com/developers/>
2. 输入您的电子邮件地址并解决Cloudflare Turnstile挑战
3. 复制您的 `pf13f_` 密钥 — **仅显示一次**
4. 将其粘贴到MCP主机的配置文件中作为 `THE13F_API_KEY`（见下文）
5. 重启主机
免费套餐：每天100次读取调用；配额在UTC凌晨重置。信号和报告工具将在付费套餐推出后在后续小版本中上线。
## 配置您的MCP主机
### Claude Desktop
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`
（macOS）或 `%APPDATA%/Claude/claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"the13f": {
"command": "uvx",
"args": ["the13f-mcp"],
"env": {
"THE13F_API_KEY": "pf13f_..."
}
}
}
}
```
重启Claude Desktop。the13f工具应该出现在MCP工具列表中。
### Cursor
设置 → MCP → 添加服务器。在“自定义”字段中粘贴相同的JSON块。
### VS Code with Continue
设置 → `experimental.modelContextProtocolServers` → 添加一个运行 `uvx the13f-mcp` 的`stdio`传输，并在环境变量中包含 `THE13F_API_KEY`。密钥显示页面 <https://the13f.com/developers/signup-success> 提供了一个复制粘贴就绪的代码片段，其中密钥已预先填写。
## 可用工具 — v0.1.0（读取套餐，免费）
| 工具 | 功能 |
|------|---------------|
| `list_quarters` | 所有包含持仓数据的季度 + 最新季度 |
| `search_managers` | 按名称自动完成13F申报者 |
| `get_manager_holdings` | 指定CIK和季度的完整持仓 |
| `get_manager_holdings_bulk` | 单次调用最多25个 `(cik, quarter)` 对 |
| `list_all_managers` | 8,600+申报者的全集，附每位申报者汇总统计 |
| `find_similar_managers` | 将投资组合与全集进行匹配 |
| `get_consensus_portfolio` | 按季度显示最广泛持有的证券 |
| `get_market_regime` | 机构制度快照（IIOI综合指数、状态、转换） |
| `get_sector_flows` | 按行业划分的资本流动和风险状况 |
## 计划工具 — 后续版本
| 版本 | 工具 | 需要 |
|---|---|---|
| v0.2.0 | `get_security_signals`, `get_security_signals_bulk`, `get_portfolio_signals` | 标准套餐订阅 |
| v0.3.0 | `generate_manager_report`, `generate_security_report`, `generate_sector_report`, `check_report_status`, `wait_and_download_report` | 标准套餐 + 存储信用卡；两步确认 |
免费套餐的读取工具足以探索数据并针对其构建提示。信号和报告工具故意依赖于付费套餐的计费管道。
## 示例提示
> “提取伯克希尔·哈撒韦公司截至2025年第四季度的前20名持仓，并总结哪些持仓环比增长最大。”
> “我等权重持有AAPL、MSFT和NVDA。找出5位机构投资者，其投资组合与我的最为相似。”
> “13F申报者上季度减少持仓最多的行业是什么？请列出减少持仓最多的前三位投资者。”
MCP主机的LLM会选择合适的工具，填写参数，显示`免责声明`，并以结构化的JSON格式返回结果。
## 环境变量
| 变量 | 默认值 | 控制内容 |
|---|---|---|
| `THE13F_API_KEY` | （无） | 您的 `pf13f_` 密钥。没有它，工具会返回一个结构化的“需要免费注册”响应，并附带一个指向注册页面的链接。 |
| `THE13F_API_BASE_URL` | `https://api.the13f.com` | 用于在运行the13f的gui_server的本地副本上进行开发的覆盖。 |
| `THE13F_MCP_TIMEOUT` | `30` | 每个请求的HTTP超时时间，单位：秒。最小值为5。 |
## 源代码
公开源代码：<https://github.com/pickelfintech/the13f-mcp>。这是PyPI、Glama.ai和MCP社区列表所指向的快照。GitHub仓库是GitLab仓库`gitlab.com/pickel-fintech/the13f-mcp`的推送镜像；GitLab仍然是主要的，并且还承载发布CI。两个仓库都接受错误报告和PR。
## 许可证
MIT — 请参阅 [`LICENSE`](./LICENSE)。托管的 `api.the13f.com` API是单独的服务。需要免费API密钥（每天100次调用）；请在 <https://the13f.com/developers/> 注册。
## 支持
tom@pickelfintech.com — 引用任何失败的工具调用返回的 `request_id` 字段，以便最快速度的故障排查。
## 许可证
MIT。请参阅 [LICENSE](../LICENSE)。MCP服务器源代码使用MIT许可证；the13f API本身的使用受 <https://the13f.com/terms.html> 服务条款的约束。
