aipulse

aipulse

aipulse 是 FalcoScan 托管 MCP 服务的轻量本地桥接工具。FalcoScan 跟踪 AI 产品格局：哪些产品存在于哪些市场、这些市场在机会、饱和度和封装风险方面的评分，以及哪些产品已停运或被收购。

该桥接工具不保留市场数据，也不自行计算评分。它会在本地提供上游服务的工具列表，与从实时端点捕获的内容完全一致，并将每次工具调用转发至上游，原样返回结果。捕获的全部内容均为只读：此重建版本没有新增写入能力。

工具

• lookup_product — 按名称（name）、网站（url）或两者查询 AI 产品。最多返回 5 个匹配结果，包括市场、运营中／已停运／已收购状态（收购方、年份和来源）、机会、饱和度和封装风险级别、定价类型、免费套餐、API 可用性、成立年份、总部、网站及 FalcoScan 链接。所有参数均为可选。
• ai_graveyard — FalcoScan 已核实停运或已被收购且各自均有公开来源的产品。可选筛选条件：year、buyer、market。每次调用最多返回 25 行，按时间从新到旧排序。
• list_markets — FalcoScan 评分的所有 AI 市场及其公开平均值（机会、饱和度、封装占比、热度）、其中运营中产品的数量，以及对应市场页面的链接。无需参数。
• market_overview — 深入查看一个市场：运营中产品数量、公开平均值、已停运或被收购的产品数量，以及排名前 10 的运营中产品及其级别。必需参数：market（市场名称或 slug）。

配置

• FALCOSCAN_MCP_URL（可选）— 覆盖上游端点。默认为 https://falcoscan.com/api/mcp。（此覆盖钩子是本重建版本自行标注的还原内容。）
• FALCOSCAN_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <key> 标头。未设置时，不会发送认证标头。（此转发机制也是本重建版本自行标注的还原内容；原始接口是在未提供密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26，clientInfo name aipulse），再发送 notifications/initialized 通知，随后发送携带调用方原样参数的 tools/call 请求。如果上游在 initialize 响应中返回 Mcp-Session-Id 标头，该值会随会话的每个后续请求发送；此会话会在进程运行期间重复使用。响应可能是普通 JSON，也可能是服务器发送事件；两种格式都会读取。

上游的成功结果会原样传递，包括上游设置的任何 isError 标记。失败情况——JSON-RPC 错误、非 2xx 状态、无法读取的响应，或无法完成的请求——会作为 isError 结果返回，其文本以 aipulse error: 开头（此呈现方式是本重建版本自行标注的还原内容）。

CLI

每个工具也可作为子命令使用，并接受一个 JSON 参数字符串（无参数的工具可省略该字符串）：

npx @reneturcios/aipulse lookup_product '{"name":"Cursor"}'
npx @reneturcios/aipulse ai_graveyard '{"year":2025}'
npx @reneturcios/aipulse market_overview '{"market":"Healthcare"}'
npx @reneturcios/aipulse list_markets
npx @reneturcios/aipulse --version

退出代码：成功时为 0，结果为 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/aipulse mcp

MCP 客户端配置：

{
  "mcpServers": {
    "aipulse": {
      "command": "npx",
      "args": ["-y", "@reneturcios/aipulse", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/aipulse
docker run --rm ghcr.io/cloudcorprecords/aipulse --version

容器的默认命令是 mcp，因此第一种形式会启动 stdio MCP 服务；任何其他参数都会照常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全使用桩接的 JSON-RPC 上游运行，不会进行实时网络调用。

许可证

MIT — 参见 LICENSE。