内容
# FalsifyLab Alpha
<!-- mcp-name: io.github.FalsifyLab/falsifylab-alpha-mcp -->
[](https://smithery.ai/servers/falsifylab/falsifylab-alpha-mcp)
[](https://pypi.org/project/falsifylab-alpha-mcp/)
[](https://pypi.org/project/falsifylab-alpha-mcp/)
[](https://pypi.org/project/falsifylab-alpha-mcp/)
[](LICENSE)
[](https://modelcontextprotocol.io/)
[](https://glama.ai/mcp/servers/FalsifyLab/falsifylab-alpha-mcp)
**MCP 数据层，用于 AI 辅助市场研究。** 13 个实时的金融工具，可与 Claude Code、Cursor、Cline、Windsurf 或任何 MCP 兼容的客户端无缝集成。免费层无需注册。
> 不是信号服务。不是投资建议。公共市场数据，轻度丰富，供 AI 代理使用。请在采取行动前进行回测。
## 使用方式
**选项 1：托管 MCP（零安装）。** 将您的代理指向托管的端点，无需 Python。
```json
{
"mcpServers": {
"falsifylab-alpha": {
"url": "https://mcp.falsifylab.com/"
}
}
}
```
免费层自动应用。付费计划通过 Whop 使用 OAuth 2.1 + PKCE 流。支持流式 HTTP 传输。完整的 OpenAPI 3.1 规范位于 https://docs.falsifylab.com/openapi.html。
**选项 2：stdio（此软件包）。**
```bash
pip install falsifylab-alpha-mcp
```
零运行时依赖（仅限 Python 标准库）。然后连接到您的代理。请参阅 [客户端设置](#客户端设置)。
## 它做什么
当用户向您的 AI 代理询问以下问题时：
- *"今日有哪些内部集群正在形成？*"
- *"显示 Hyperliquid 保险库的夏普比率和 10% 的回撤率。*"
- *"BTC ETF 资金流是否确认或偏离价格走势？*"
- *"当前宏观行情如何？*"
- *"找到 Polymarket 鲸鱼，胜率超过 60%。*"
... 代理将调用其中一个工具，并根据公开市场数据的实时数字得出答案，而不是根据训练数据的知识进行推测。
## 13 个工具
| 工具 | 返回值 | 用例 |
|------|---------|----------|
| `top_yield_farms` | 去除排放、价格风险的 DeFi 收益 | 找到真实收益，而不是表面收益 |
| `hl_vault_leaderboard` | Hyperliquid 保险库按 NAV / 30 天 / 回撤率 / 评分排序 | 复制交易参考 |
| `insider_buy_clusters` | SEC Form 4 集群购买（3+ 内部人员，24 小时窗口） | 股权确认信号 |
| `sec8k_material_today` | 按重要事项代码筛选的 8-K 文件 | 收益、并购、官员变更 |
| `macro_tape` | SPX/NDX/VIX/UST/DXY/GOLD/WTI/BTC/ETH 快照 | 交易创意机制 |
| `etf_flow_today` | 美国现货 BTC + ETH ETF 聚合 | 机构定位 |
| `active_airdrop_farms` | DefiLlama 收益差距空投 | 等待付款的农场 |
| `polymarket_whale_positions` | 顶级钱包 + 活动仓位 | 预测市场复制交易 |
| `earnings_drift_radar` | 盈利漂移 + IV 粉碎候选人 | 股权事件波动扫描器 |
| `token_unlock_radar` | 前向代币解锁计划 + 规模 | 供应过剩风险雷达 |
| `fed_comm_radar` | 美联储发言人/事件波动窗口 | 宏观事件风险扫描器 |
| `confluence_today` | 跨源信号对齐 | 在同一资产上堆叠 2+ 个信号 |
| `onchain_smart_wallets` | 实时 Solana 复制交易机器人分数 | 生产钱包排名 |
所有工具都在 [/.well-known/mcp/server-card.json](https://falsifylab.com/.well-known/mcp/server-card.json) 处公开了完整的 JSON 模式。
## 客户端设置
### Claude Code
```bash
claude mcp add falsifylab-alpha -- python -m falsifylab_alpha_mcp
```
对于 Pro 层：
```bash
claude mcp add falsifylab-alpha \
--env FL_API_KEY=fl_your_key \
-- python -m falsifylab_alpha_mcp
```
### Cursor
在 `~/.cursor/mcp.json` 或工作区根目录 `.mcp.json` 中添加：
```json
{
"mcpServers": {
"falsifylab-alpha": {
"command": "python",
"args": ["-m", "falsifylab_alpha_mcp"],
"env": {
"FL_API_KEY": "fl_your_key_or_omit_for_free_tier"
}
}
}
}
```
重启 Cursor。工具自动发现。
### Cline
设置 → MCP 服务器 → 添加服务器。粘贴与 Cursor 相同的 JSON。
### Windsurf
设置 → MCP。相同的 JSON 配置。Smithery 内 48 小时内自动索引。
### Smithery
通过 Smithery 的托管网关连接 - 无需本地 Python 安装。参见 [smithery.ai/servers/falsifylab/falsifylab-alpha-mcp](https://smithery.ai/servers/falsifylab/falsifylab-alpha-mcp)。
## 验证安装
在您的代理中询问：
> 使用 macro_tape。显示给我 SPX、VIX、BTC、ETH 的 1 天和 5 天回报率。
如果代理返回数字，则表示您已上线。
## 有效的代理提示
复制并粘贴这些。它们在第一次运行时有效。
**每日宏观简报：**
```
使用 macro_tape。告诉我当前的宏观行情，3 句话。引用具体
数字 - 最新价格、1 天回报率、5 天回报率。然后列出 2 个可能受益于此行情的 sec8k_material_today ticker。
```
**内部 + 8-K 堆叠器：**
```
运行 insider_buy_clusters（min_insiders=3）和 sec8k_material_today
（items=["2.02","8.01","5.02"]）。在 24 小时内找到同时满足这两个条件的 ticker。对于
每个匹配项，总结内部人员购买的内容和 8-K 的内容。最后
用一句话总结看跌理由。
```
**具有看跌理由的 Confluence 扫描：**
```
使用 confluence_today，min_signals=2。对于每个资产/ticker，解释
为什么这些信号的堆叠有意义，2 句话。跳过噪音
（稳定币的 DeFi LP 池）。突出最矛盾的堆叠。
```
[falsifylab.com/cookbook](https://falsifylab.com/cookbook) 上有 8 个更多配方。
## 定价
| 层级 | 价格 | 功能 |
|------|-------|------|
| 免费 | $0 | 24 小时缓存，10 个结果/查询，无需注册，60 请求/小时 |
| 专业 | $19/月 | 实时（5 分钟），100 个结果/查询，90 天历史记录，无速率限制 |
| 专业增强版 | $49/月 | 1 分钟刷新，电子邮件 + Slack 警报，股权饲料 365 天，网络钩子 |
| 团队 | $199/月 | 5 个席位，50k 请求/天，优先支持 |
启动促销 `EARLY50`：前 3 个月 50% 折扣，限 25 次兑换。在 [falsifylab.com/pro](https://falsifylab.com/pro) 获取密钥。
## 实时演示
公共代理每 15 分钟调用这些工具： [falsifylab.com/demo](https://falsifylab.com/demo)。与您安装的相同 MCP 服务器。实时数字，无需策划。
## 为什么存在
因为作者每天早上 6 点手动抓取 SEC EDGAR 和 DefiLlama 来为交易机器人提供数据。幸存的机器人从这个确切的管道中获取数据。将它封装成 MCP 服务器，以便任何代理都可以提取相同的数据。
交易机器人收据（存活 + 死，P&L，回撤）在 [falsifylab.com/vaults](https://falsifylab.com/vaults) 处公开。
## 透明度
- **我们做什么**：聚合 + 轻度丰富公共市场数据，通过 MCP 暴露
- **我们不做什么**：交易执行、经纪、咨询、信号销售
- **数据源**：SEC EDGAR（Form 4，8-K），SoSoValue（ETF 资金流），DefiLlama（收益），Hyperliquid 公共 API，Polymarket 公共 API，Yahoo Finance（宏观）
- **隐私**：免费层密钥由 hash(IP+UA) 发行，不长期存储。请求体从不记录。
## 遥测
本地_stdio 服务器将最小的每个工具遥测 JSONL 行写入：
- `/var/log/falsifylab/mcp_tool_calls.jsonl`（覆盖 `FL_MCP_TOOL_CALL_LOG`）
每行仅包含：
- `ts`、`tool`、`args_keys`（仅参数名称）、`has_api_key`、`key_hash`（sha256 前缀）、`version`
此遥测路径从不记录：
- 原始 API 密钥
- 参数值/请求体
- IP 地址
- 电子邮件/姓名/其他用户标识符
要完全禁用遥测：
```bash
export FL_DISABLE_TELEMETRY=1
```
## 有效、不生效
诚实的清单。每发布一次更新。
### 今日生效
- 所有 13 个工具在 1 秒内返回代理调用中的实时数据。
- 免费层具有零注册摩擦。缓存路径不需要 API 密钥。
- Form 4 内部集群每 15 分钟在工作日从 SEC EDGAR 直接刷新，无需第三方转售商。
- DefiLlama 收益扣除排放（标头 APY 减去奖励代币），因此 200% 的农场和 200% 的农场不再是相同的数字。
- Hyperliquid 保险库 NAV 更新在源 ticker 60 秒内到达我们的 R2 镜像。
- Pro Plus 上的 Telegram + Slack 网络钩子交付在 cron 窗口内准时。启动月份内无队列备份。
### 还未生效（但正在开发）
- 8-K 材料申报列表在周末为空，因为 SEC 不会提交。返回 `count: 0` Sat/Sun。预期。
- 宏观行情使用 Yahoo Finance 免费端点。在美国市场交易时间内有 15-20 分钟的盘中缺口。我们计划在 Teams 层更换为付费源。
- `onchain_smart_wallets` 目前仅覆盖 Solana。Base + Ethereum 复制交易分数已排队 v0.3.x。
- 免费层缓存为 24 小时。因此，在免费密钥上 `confluence_today` 显示昨天的汇聚，而不是今天的汇聚。$19/月 Pro 计划实时生效。
- 跨多个季度的历史重放不在 v0.2.x 中。作为路线图项目跟踪。
- TypeScript 或 Go 尚无 SDK。仅限 Python MCP 服务器。使用 stdio 传输来自任何 MCP 兼容客户端。
### 我们已经终止
- Stripe Connect 直接订阅（运营商 KYC 阻止器）。Whop 是路径。
- Substack 付费计划（Stripe 依赖）。
- 前一个软件包版本 0.2.0 发布了一个损坏的 `api.falsifylab.com` 主机。在 0.2.1 版本中修复，4 天内修复。如果您首先获得了 0.2.0 版本，请道歉。
如果您发现某些问题已损坏，请发送 DM 给 FL X 账户或打开问题。我们在同一天发布生产阻塞错误修复。
## 架构
```
您的 AI 代理
↓（MCP stdio）
falsifylab_alpha_mcp（Python stdlib，无依赖）
↓（HTTPS）
falsifylab.com/api/*（Cloudflare Workers）
↓（缓存 60s-1hr）
R2（每 15 分钟通过 cron 刷新数据馈送）
↓（每 15 分钟）
后端 cron 脚本（Form 4，8-K，ETF，收益，polymarket，onchain 等）
```
免费层访问缓存数据，年龄为 24 小时。Pro 层访问相同的端点，带有身份验证头，绕过缓存以获取新鲜的上游数据。
## 链接
- **实时演示**： [falsifylab.com/demo](https://falsifylab.com/demo)
- **安装指南**： [falsifylab.com/install](https://falsifylab.com/install)
- **食谱大全**： [falsifylab.com/cookbook](https://falsifylab.com/cookbook)
- **定价**： [falsifylab.com/pro](https://falsifylab.com/pro)
- **比较**（vs Token Terminal / Nansen / Dune）： [falsifylab.com/vs](https://falsifylab.com/vs)
- **MCP 服务器卡**： [/.well-known/mcp/server-card.json](https://falsifylab.com/.well-known/mcp/server-card.json)
- **Substack**： [falsifylab.substack.com](https://falsifylab.substack.com)
- **PyPI**： [pypi.org/project/falsifylab-alpha-mcp](https://pypi.org/project/falsifylab-alpha-mcp/)
- **Smithery**： [smithery.ai/servers/falsifylab/falsifylab-alpha-mcp](https://smithery.ai/servers/falsifylab/falsifylab-alpha-mcp)
- **代理启动仓库**： [github.com/opsfalsifylab/falsifylab-agent-starter](https://github.com/opsfalsifylab/falsifylab-agent-starter)
## 支持
- **问题**： [GitHub issues](https://github.com/FalsifyLab/falsifylab-alpha-mcp/issues)
- **电子邮件**： ops@falsifylab.com
- **安全**： 发送至 ops@falsifylab.com，主题为 `[security]`。48 小时响应。披露后在 CHANGELOG 中记录。
## 贡献
欢迎提交 PR：
- 新的工具想法（首先打开问题讨论范围）
- 文档改进
- 错误修复
不要提交 PR 以生成交易信号或复制交易助手 - 超出此服务器的范围（我们是研究数据基础设施，而不是咨询）。
## 许可证
MIT。参见 [LICENSE](LICENSE)。
*FalsifyLab Alpha v0.3.3 · 为 AI 编码代理构建 · 免费层无需注册 · falsifylab.com*
