signal8-mcp

# @signal8ai/mcp MCP（模型上下文协议）服务器，为 [Signal8](https://signal8.ai) 提供——AI 提取的美国证券交易委员会（SEC）申报文件情报数据。 为 Claude、Cursor 和其他 MCP 兼容工具等 AI 代理提供直接访问： - **公司基本信息** （行情、财务数据、盈利数据、流通股、执行董事、同行公司、新闻） - **稀释风险评分** （0-100 稀释压力评分，5 维评估） - **SEC 申报文件提取** （认股权证、可转换证券、货架登记等 10 多种类型） - **工具生命周期跟踪** （认股权证、可转换证券、ATM 及 XBRL 调节） - **情报** （交易对手、法律顾问、内部人员、机构、优先购买权触发、集群购买） - **跨公司情报** （顶级资产管理机构、跨公司法律顾问及内部人员模式） - **合规监控** （Nasdaq/NYSE 缺陷检测、上市分类） - **公司筛选** （稀释感知过滤器，30 多个字段） - **ETF 分析** （持仓、板块、国家、业绩、可比公司） ## 安装 ```bash npm install -g @signal8ai/mcp # 或使用 npx（无需安装） npx @signal8ai/mcp ``` ## 设置 ### 1. 获取您的 API 密钥 在 [signal8.ai/mcp](https://signal8.ai/mcp) 注册并在 [signal8.ai/settings/api-keys](https://signal8.ai/settings/api-keys) 创建密钥以获取您的 API 密钥。 ### 2. 配置您的 MCP 客户端 #### Claude Desktop 将以下内容添加到您的 Claude Desktop 配置文件中： **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "signal8": { "command": "npx", "args": ["-y", "@signal8ai/mcp"], "env": { "SIGNAL8_API_KEY": "sk_live_your_key_here" } } } } ``` #### Cursor 在项目根目录的 `.cursor/mcp.json` 中添加： ```json { "mcpServers": { "signal8": { "command": "npx", "args": ["-y", "@signal8ai/mcp"], "env": { "SIGNAL8_API_KEY": "sk_live_your_key_here" } } } } ``` #### 其他 MCP 客户端 设置 `SIGNAL8_API_KEY` 环境变量并运行： ```bash SIGNAL8_API_KEY=sk_live_your_key_here npx @signal8ai/mcp ``` ## 可用工具（86） 服务器在运行时公开 **86 个实时工具**。下面的参考表是按领域分组的代表性目录；几个文档化的工具和整个类别（例如提取和稀释）当前处于禁用状态，因此单个部分计数可能超过实际公开的内容。 ### 公司（3 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `search_companies` | 按名称或股票代码搜索公司 | 1 | | `get_company_profile` | 完整的公司简介（描述、市值、板块） | 1 | | `get_company_bundle` | 统一的数据包 | 25 | ### 公司数据（13 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_quote` | 实时股票行情（价格、变化、交易量） | 1 | | `get_market_metrics` | 交易量均值、波动率、SMA、趋势方向 | 3 | | `get_short_interest` | 空头兴趣数据和覆盖天数 | 3 | | `get_float` | 流通股构成、流通股数量、所有权百分比 | 3 | | `get_financials` | 损益表、资产负债表、现金流量表 | 5 | | `get_earnings` | 盈利历史和 EPS 意外 | 3 | | `get_executives` | 高管团队和薪酬 | 1 | | `get_peers` | 同行公司 | 1 | | `get_transcripts` | 盈利电话会议记录 | 3 | | `get_news` | 最新公司新闻标题 | 1 | | `get_analyst_consensus` | 分析师评级和目标价格 | 3 | | `get_material_events` | 重大公司事件（8-K 申报） | 3 | | `get_clinical_trials` | 临床试验流程（生物技术/制药） | 3 | ### 市场 — 跨股票代码（6 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_quotes_batch` | 批量实时行情，最多 200 个股票代码（POST） | max(1, ceil(N/10)) | | `get_quotes_universe` | 整个指数宇宙的行情（sp500/ndx/dji） | 5 | | `get_index_snapshot` | 批量股票快照（价格、日变化、% 变化） | 1 | | `get_sector_etf_snapshot` | 11 个 SPDR 板块 ETF 的快照，附板块标签 | 2 | | `get_top_movers` | 按方向划分的顶级变动者（涨幅、跌幅或交易量最大），可选 `session` 窗口 | 2 | | `get_market_breadth` | 进/退计数和比率、50/200 日均线以上百分比、新 52 周高/低计数 | 2 | ### 日历（5 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_earnings_calendar` | 两个日期之间的即将到来的/最近的盈利发布 | 3 | | `get_economic_calendar` | 宏观/经济事件（CPI、FOMC、就业、GDP）按日期和国家 | 3 | | `get_filing_calendar` | 10-K / 10-Q SEC 申报截止日期日历，按宇宙分类 | 5 | | `get_lockup_expirations` | 即将到来的 IPO/二次锁定期到期 | 5 | | `get_recent_material_filings` | 最近的重要 8-K 申报，按指数宇宙和项目代码分类 | 5 | ### 提取（4 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_extractions` | AI 提取的 SEC 申报文件数据（13 种类型） | 5 | | `get_filing_extractions` | 特定 SEC 申报文件的提取 | 5 | | `get_extraction_dashboard` | 跨公司提取分析 | 50 | | `get_extraction_by_type` | 按类型筛选提取（认股权证、可转换证券等） | 5 | ### 稀释（5 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_dilution_risk` | 稀释压力评分（0-100），5 维评估 | 5 | | `get_dilution_performance` | 1d/7d/30d/90d 后的稀释后股票表现 | 10 | | `get_instruments` | 活跃的认股权证、可转换证券、ATM、货架登记 | 5 | | `get_instrument_detail` | 单个工具的深入研究 | 5 | | `get_baby_shelf` | IB6 baby shelf 剩余容量 | 10 | ### 情报 — 每公司（12 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_counterparties` | 实体解析的交易对手关系 | 10 | | `get_counsel` | 法律顾问聘用，附角色分类 | 10 | | `get_insiders` | 内幕交易发现和模式 | 10 | | `get_ownership` | 统一所有权（Form 4 + 13F + 13D/G） | 10 | | `get_rofr_triggers` | 优先购买权触发检测 | 10 | | `get_institutions` | 13F 申报机构持股 | 10 | | `get_institution_detail` | 特定机构的详细信息（按 CIK） | 10 | | `get_institution_holdings` | 机构的完整投资组合持仓 | 10 | | `get_banks` | 美国证券交易委员会申报文件中的投资银行关系 | 10 | | `get_legal_counsels` | 法律顾问关系，附合作伙伴名称 | 10 | | `get_insider_transactions` | 详细的 Form 4 交易历史 | 5 | | `get_insider_cluster_buys` | 集群购买模式检测（3 名内幕人士在 14 天内） | 10 | ### 情报 — 跨公司（3 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_institution_top_aum` | 按 AUM 划分的顶级机构持有者，涵盖所有公司 | 25 | | `get_counsel_cross_company` | 多家公司间的法律顾问聘用 | 25 | | `get_insider_cross_company` | 多家公司间的内幕交易模式 | 25 | ### 合规（4 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_compliance` | 完整的合规性评估 | 25 | | `get_deficiencies` | 上市缺陷检测 | 10 | | `get_compliance_alerts` | 活跃的合规警报 | 5 | | `get_listing_classification` | 交易所上市分类 | 10 | ### 筛选器（2 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_screener_fields` | 发现可用的筛选字段 | 1 | | `screen_companies` | 稀释感知公司筛选器 | 25 | ### 事件 & ATM（2 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_events` | 统一的公司事件 | 5 | | `get_atm_activity` | ATM 程序监控 | 5 | ### ETF（1 个工具） | 工具 | 描述 | 积分 | | --- | --- | --- | | `get_etf_bundle` | 集成的 ETF 数据（简介、持仓、板块、业绩） | 25 | ## 市场情报 — 工具参考 跨股票代码的市场和日历工具，适用于整个宇宙而非单个公司。为完整起见，这里包括单个股票代码的 `get_quote` 工具，其余工具在市场情报发布时添加。 --- ### `get_quote` 单个股票代码的实时行情（价格、变化、交易量、日范围） **输入： | 名称 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | ticker | 字符串 | 是 | 股票代码（例如 `AAPL`） | **示例输出（常规交易时间，9:30am–4:00pm ET）：** ```json { "data": { "ticker": "AAPL", "currentPrice": 178.42, "change": 2.15, "changePercent": 1.22, "high": 179.10, "low": 176.80, "open": 177.05, "previousClose": 176.27, "preMarketPrice": null, "preMarketChangePercent": null, "afterHoursPrice": null, "afterHoursChangePercent": null, "timestamp": 1714492800 } ``` **示例输出（扩展时间 - 盘前或盘后）：** ```json { "data": { "ticker": "AAPL", "currentPrice": 178.42, "change": 2.15, "changePercent": 1.22, "high": 179.10, "low": 176.80, "open": 177.05, "previousClose": 176.27, "preMarketPrice": 179.05, "preMarketChangePercent": 0.35, "afterHoursPrice": 178.90, "afterHoursChangePercent": 0.27, "timestamp": 1714492800 } ``` > **扩展时间窗口（美国股票交易时间，ET）：** 盘前 4:00am–9:30am，盘后 4:00pm–8:00pm. 在这些窗口之外，`preMarketPrice`、`preMarketChangePercent`、`afterHoursPrice` 和 `afterHoursChangePercent` 为 `null`.实际上，只有一对同时生效，根据当前窗口 - 第二个示例显示两者都显示示例说明。 **用例： “AAPL 现在交易多少？” --- ### `get_quotes_batch` 获取最多 200 个股票代码的实时行情。支持 ``get_quotes_batch` 获取最多 200 个股票代码的实时行情。依赖于 `POST /api/v1/public/market/quotes`。缺失的股票代码映射到 `null`。 **输入： | 名称 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | tickers | 字符串数组 | 是 | 1-200 个股票代码 | **示例输出： ```json { "data": { "count": 3, "quotes": { "AAPL": { "ticker": "AAPL", "currentPrice": 178.42, "changePercent": 1.22 }, "MSFT": { "ticker": "MSFT", "currentPrice": 412.10, "changePercent": 0.41 }, "NVDA": null } } } ``` **用例： “提取 50 个股票代码的实时行情”** --- ### `get_quotes_universe` 获取已知指数宇宙（S\&P 500、Nasdaq 100 或 Dow 30）的行情。 **输入： | 名称 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | universe | 枚举 | 是 | `sp500`、`ndx` 或 `dji` 之一 | **示例输出： ```json { "data": { "universe": "dji", "count": 30, "quotes": { "AAPL": { "currentPrice": 178.42, "changePercent": 1.22 }, "MSFT": { "currentPrice": 412.10, "changePercent": 0.41 } } } } ``` **用例： “给我一个 Dow 30 指数成分股的实时行情快照”** --- ### `get_index_snapshot` 批量每日快照（OHLC，交易量，% 变化）对于明确的股票代码列表（最多 50 个）或省略时跟踪的整个宇宙。 **输入：** _无需输入_（REST 调用时可选 `tickers` 查询） **示例输出： ```json { "data": { "count": 2, "snapshots": [ { "ticker": "SPY", "close": 512.34, "changePercent": 0.42, "volume": 78321000 }, { "ticker": "QQQ", "close": 438.21, "changePercent": 0.55, "volume": 41902000 } ] } } ``` **用例： “显示指数 ETF 收盘时的行情”** --- ### `get_sector_etf_snapshot` 11 个 SPDR 板块 ETF（XLK、XLF、XLV、XLY、XLP、XLE、XLI、XLB、XLRE、XLU、XLC）的快照，每个板块一行。适用于板块轮动视图。 **输入：** 无 **示例输出： ```json { "data": { "count": 11, "sectors": [ { "ticker": "XLK", "sector": "Technology", "close": 218.40, "changePercent": 0.85 }, { "ticker": "XLF", "sector": "Financials", "close": 41.23, "changePercent": -0.12 } ] } } ``` **用例： “哪些板块今天领涨和落后？”** --- ### `get_top_movers` 按方向（涨幅、跌幅或交易量）计算的热门变动股票，来源于 `ticker_snapshots`. 不包括认股权证/单位/ETF/基金。 **输入： | 名称 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | direction | 枚举 | 是 | `gainers`、`losers` 或 `active` | | limit | 整数 | 否 | 1-100（后端默认应用时省略） | | session | 枚举 | 否 | `premarket`（4:00–9:30 AM ET），`regular`（默认；close-to-close），或 `afterhours`（4:00–8:00 PM ET）。在非交易时间发布时使用 premarket/afterhours，以便排名反映实时窗口。 | **示例输出： ```json { "data": { "direction": "gainers", "session": "regular", "count": 2, "movers": [ { "rank": 1, "ticker": "XYZ", "name": "Acme Corp", "price": 12.34, "changePercent": 42.1, "volume": 12000000, "marketCap": 350000000, "isETF": false }, { "rank": 2, "ticker": "ABC", "name": "ABC Inc", "price": 5.62, "changePercent": 31.8, "volume": 8400000, "marketCap": 120000000, "isETF": false } ] } } ``` **用例： “今日涨幅前 10 名是什么？”** --- ### `get_market_breadth` 市场广度聚合指标（涨跌计数和比率，50/200 日均线以上百分比，以及新 52 周高/低计数），适用于选择的宇宙。仅限实时 - 无历史广度。 **输入： | 名称 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | universe | 枚举 | 否 | `sp500`（默认），`ndx` 或 `all` | **示例输出： ```json { "data": { "universe": "sp500", "asOf": "2026-04-30T20:00:00.000Z", "advancers": 312, "decliners": 175, "unchanged": 16, "advanceDeclineRatio": 1.7828571428571428, "pctAbove50DMA": 0.642, "pctAbove200DMA": 0.561, "new52wHighs": 18, "new52wLows": 4 } } ``` **用例： “现在有多少 S\&P 500 股票价格高于其 200 日均线？” 或 “为今日市场状态评论添加一行市场状态头部。”** --- ### `get_earnings_calendar` 两个日期之间的即将到来的和最近的盈利发布。可选地筛选到股票代码列表。 **输入： | 名称 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | from | 字符串（YYYY-MM-DD） | 是 | 窗口开始 | | to | 字符串（YYYY-MM-DD） | 是 | 窗口结束 | | tickers | 字符串数组 | 否 | 可选的股票代码筛选器 | **示例输出： ```json { "data": { "events": [ { "ticker": "AAPL", "date": "2026-05-02", "time": "AMC", "epsEstimate": 1.50, "revenueEstimate": 90100000000 } ], "total": 1, "limit": 50, "offset": 0 } } ``` **用例： “哪些大型股下周发布财报？”** --- ### `get_economic_calendar` 两个日期之间的宏观经济事件（CPI、FOMC、NFP、GDP 等），按国家和影响程度筛选。 **输入： | 名称 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | from | 字符串（YYYY-MM-DD） | 是 | 窗口开始 | | to | 字符串（YYYY-MM-DD） | 是 | 窗口结束 | | country | 字符串（ISO-2） | 否 | 默认 `US` | **示例输出： ```json { "data": { "events": [ { "date": "2026-05-07", "country": "US", "event": "FOMC Rate Decision", "impact": "High", "actual": null, "forecast": "5.25%", "previous": "5.25%" } ], "total": 1 } } ``` **用例： “本周有哪些高影响力的美国经济事件？”** --- ### `get_filing_calendar` 按指数宇宙划分的 10-K / 10-Q SEC 申报截止日期日历。截止日期根据每家公司最近报告的期间结束日期 + 提交者状态偏移量计算。 **输入： | 名称 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | from | 字符串（YYYY-MM-DD） | 否 | 默认今天 | | to | 字符串（YYYY-MM-DD） | 否 | 默认今天 + 45 天 | | universe | 枚举 | 否 | `sp500`、`ndx`、`dji` 或 `all`（默认） | | formTypes | 字符串数组 | 否 | `[“10-K”, “10-Q”]` 的子集 | **示例输出： ```json { "data": { "rows": [ { "ticker": "AAPL", "companyName": "Apple Inc.", "formType": "10-Q", "periodEnd": "2026-03-29", "deadline": "2026-05-13", "daysUntilDeadline": 13, "filerStatus": "large_accelerated" } ], "count": 1, "window": { "from": "2026-04-30", "to": "2026-06-14" }, "universe": "sp500", "formTypes": ["10-K", "10-Q"] } } ``` **用例： “哪些 S\&P 500 名称的 10-Q 截止日期在接下来的两周内？”** --- ### `get_lockup_expirations` 即将到来的 IPO/二次锁定期到期，基于招股说明书条款提取（S-1 / F-1 / 424B*）。覆盖范围部分；检查 `meta.coveragePercent`. **输入： | 名称 | 类型 | 必需 | 描述 | | --- | --- | --- | --- | | from | 字符串（YYYY-MM-DD） | 否 | 默认今天 | | to | 字符串（YYYY-MM-DD） | 否 | 默认今天 + 90 天 | | universe | 枚举 | 否 | `sp500`、`ndx`、`dji` 或 `all`（默认） | **示例输出： ```json { "data": { "rows": [ { "ticker": "NEWCO", "companyName": "NewCo Inc.", "lockupEndDate": "2026-05-21", "daysUntilExpiry": 21, "originalFilingType": "S-1", "sharesUnlocking": 24500000, "sourceFilingUrl": "https://sec.gov/..." } ], "meta": { "coveragePercent": 38.4, "totalCandidates": 412, "parsedCount": 158, "windowStart": "2026-04-30", "windowEnd": "2026-07-29", "universe": "all" } } } ``` **用例： “未来 30 天内有哪些 IPO 锁定期到期？”** --- ### 获取最近的重要材料申报 指定指数范围内的最近8-K申报，被标记为材料重要性， 可选地按项目代码过滤（例如 1.01 材料协议，5.02 领导层变动）。 查找范围固定为 7 天。 **输入参数：** | 名称 | 类型 | 必需 | 描述 | |------|------|----------|-------------| | universe | 枚举 | 是 | `sp500`, `ndx`, 或 `dji` | | items | 字符串数组 | 否 | 8-K 项目代码（例如 `["1.01", "2.01"]`） | | limit | 整数 | 否 | 1–200（默认 50） | **示例输出：** ```json { "data": { "universe": "sp500", "items": ["1.01", "5.02"], "count": 1, "filings": [ { "ticker": "AAPL", "companyName": "苹果公司", "filingDate": "2026-04-29T20:15:00Z", "formType": "8-K", "items": ["1.01"], "filingUrl": "https://sec.gov/...", "summary": "已签订具有约束力的协议..." } ] } } ``` **用例：** "本周标普500指数中有关领导层变动的8-K申报有哪些？" --- ## 资源 | 资源 | URI | 描述 | |----------|-----|-------------| | 公司简介 | `signal8://companies/{ticker}/profile` | 按股票代码获取的丰富公司简介 | | 提取类型 | `signal8://extraction-types` | 所有13种SEC申报提取类型的列表 | ## 提示（4） | 提示 | 参数 | 描述 | |--------|-----------|-------------| | `analyze_dilution_risk` | `ticker`（字符串） | 6步稀释风险分析工作流程 | | `company_due_diligence` | `ticker`（字符串） | 10步全面尽职调查研究 | | `screening_workflow` | `sector?`, `marketCapMax?` （字符串） | 5步发现-筛选-分析工作流程 | | `institutional_analysis` | `ticker`（字符串） | 6步机构所有权与智能资金分析 | ## 主机端点 对于基于Web的MCP客户端，请使用托管的Streamable HTTP端点： ``` POST https://mcp.signal8.ai/mcp Authorization: Bearer sk_live_your_key_here Content-Type: application/json ``` 此Streamable HTTP端点目前适用于支持自定义Bearer令牌标头的MCP客户端（例如Claude Code CLI的 `--transport http` 连接器，Cursor和VS Code的MCP支持）。基于OAuth的发现功能适用于Claude.ai Desktop/web自定义连接器 **即将推出** — 在此之前，请使用上述stdio配置（npx），或在客户端允许的情况下直接传递 `Authorization` 标头。 ## 环境变量 | 变量 | 必需 | 描述 | |----------|----------|-------------| | `SIGNAL8_API_KEY` | 是 | 您的Signal8 API密钥（以 `sk_live_` 或 `sk_test_` 开头） | | `SIGNAL8_API_URL` | 否 | API基准URL（默认： `https://api.signal8.ai/api/v1/public`） | ## 定价 每个工具调用根据访问的端点消耗信用额度。 查看上述工具表格中的信用额度费用。 在 [signal8.ai](https://signal8.ai) 上获取您的免费额度（每天100信用额度）。 ## 程序化使用 ```typescript import { createMcpServer, Signal8ApiClient } from '@signal8ai/mcp'; const client = new Signal8ApiClient({ baseUrl: 'https://api.signal8.ai/api/v1/public', apiKey: 'sk_live_xxx', }); const server = createMcpServer(client); // 连接到任何MCP传输... ``` ## 许可证 MIT -- 请参阅 [LICENSE](./LICENSE) 文件。 版权所有 (c) 2025-2026 Signal8 AI, Inc. 使用托管的Signal8 API和数据还受Signal8 [服务条款](https://signal8.ai/terms)的管辖。