algoum-mcp

面向 AI 助手的 algoum-mcp（MCP）

让你的 AI 助手通过模型上下文协议查询美国金融监管数据，数据来自 SEC EDGAR，包括内幕交易（Form 4/5）、重大事件（8-K）和机构持仓（13F）。用自然语言提问，助手会为你查找数据。

你可以询问什么

告诉助手你想了解什么，它会为你选择合适的工具。

内幕交易（Form 4 和 5）

高管、董事和持股 10% 以上的股东申报的买入和卖出记录——可以查询单家公司，也可以查询整个市场；还可以查看据此得出的信号：买入行为集中的情况，以及公司高管的买入／卖出比率。

• “过去 7 天里，哪些内部人士买入了 NVIDIA 股票？”
• “过去 14 天里，有哪些公司至少有 3 名内部人士买入？”
• “过去 90 天，Tesla 高管的买入／卖出比率是多少？”
• “显示近期整个市场的内部人士卖出记录。”

重大事件（Form 8-K）

公司必须披露的事件——领导层变动、并购、破产、网络安全事件、财报发布等——既可以按历史记录搜索，也可以查看所有公司的最新申报。

• “今天有哪些关于网络安全事件的 8-K 申报？”
• “Boeing 今年报告了哪些重大事件？”
• “过去 24 小时内有没有破产申报？”

机构持仓（Form 13F）

机构投资者的季度投资组合，以及按股票汇总的情况：有多少只基金持有该股票，以及有多少只基金新建、增持或减持了仓位。

• “2026-Q1 哪些机构持有 Apple？机构情绪如何？”
• “显示 Bridgewater 最近申报季度的投资组合。”
• “上个季度有多少只基金增持了 Microsoft？”
• “本周有哪些 13F 披露？”

公司和申报文件

查询股票代码和公司信息、查看每条记录背后的 SEC 原始申报文件，以及了解各数据源的更新情况。

• “Palantir 的 CIK 是什么？”
• “给我这笔交易对应的 SEC 申报文件。”
• “数据有多新？”

助手也可以在需要更多详情时自行查阅 API 描述。

须知

• 只读访问已发布的 SEC 数据，数据直接取自官方申报文件。
• 内幕交易和重大事件会在申报后几分钟内提供。
• 时间戳采用美国东部时间，与 SEC 报告的时间完全一致。
• 13F 数值是基金申报的季度持仓，因此反映的是持仓情况，而非资金流动。
• 助手随时可以查询当前的数据更新情况。

有问题，或有想要查看的数据？联系我们——我们期待听到你的想法。

API 可免费使用。如果它对你有帮助，捐赠能帮助我们维持服务运行。

设置

1. 获取 API 密钥

在 algoum portal 的控制面板中创建密钥——也就是你用于 REST API 的同一个密钥。每个应用或设备各创建一个密钥，便于分别管理；你可以随时添加或撤销密钥。

将密钥保存在环境变量中，或让你的应用提示输入：

export ALGOUM_API_KEY='<your key>'

2. 检查连接

curl -s https://api.algoum.de/v1/mcp \
  -H "Authorization: Bearer $ALGOUM_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

3. 将服务添加到助手

有些助手可以为你安装服务——在 MCP Registry 中查找 algoum。使用 APM 时，只需运行两条命令即可为你的助手完成设置。否则请使用下方的配置值。

URL	https://api.algoum.de/v1/mcp
传输方式	Streamable HTTP
身份验证	将你的 API 密钥用作 Authorization: Bearer <key>

VS Code（GitHub Copilot）

在项目中创建 .vscode/mcp.json（或运行 MCP: Open User Configuration，以在所有项目中使用）。VS Code 会在首次启动时询问密钥，且不会将其存储在文件中：

{
  "inputs": [
    { "type": "promptString", "id": "algoum-key", "description": "algoum API key", "password": true }
  ],
  "servers": {
    "algoum-mcp": {
      "type": "http",
      "url": "https://api.algoum.de/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:algoum-key}" }
    }
  }
}

将聊天切换到 Agent 模式，并在工具列表中确认 algoum-mcp 工具已启用。

IntelliJ IDEA 和其他 JetBrains IDE

这两种方式适用于所有 JetBrains IDE。请根据已安装的助手选择相应方式。

GitHub Copilot 插件

1. 打开 Settings → Tools → GitHub Copilot → Model Context Protocol (MCP)，然后点击 Configure。这会打开 mcp.json。

2. 添加服务：

   {
     "servers": {
       "algoum-mcp": {
         "type": "http",
         "url": "https://api.algoum.de/v1/mcp",
         "headers": { "Authorization": "Bearer <your key>" }
       }
     }
   }
   

3. 打开 Copilot 聊天，切换到 Agent 模式，并确认列表中显示了 algoum-mcp 工具。

JetBrains AI Assistant

1. 打开 Settings → Tools → AI Assistant → Model Context Protocol (MCP)，然后点击 Add。

2. 选择 As JSON 并粘贴：

   {
     "mcpServers": {
       "algoum-mcp": {
         "url": "https://api.algoum.de/v1/mcp",
         "headers": { "Authorization": "Bearer <your key>" }
       }
     }
   }
   

3. 保存并等待服务显示为已连接。

密钥会保留在你本机 IDE 自己的配置中。

Claude Code

claude mcp add --transport http algoum-mcp https://api.algoum.de/v1/mcp \
  --header "Authorization: Bearer $ALGOUM_API_KEY"

使用 claude mcp list 验证。

Cursor

在项目中创建 .cursor/mcp.json（或创建 ~/.cursor/mcp.json 以供所有项目使用）。密钥会从你在步骤 1 中导出的环境变量中读取，因此不会写入文件：

{
  "mcpServers": {
    "algoum-mcp": {
      "url": "https://api.algoum.de/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:ALGOUM_API_KEY}" }
    }
  }
}

在设置了 ALGOUM_API_KEY 的 shell 中启动 Cursor，然后检查 Settings → MCP，确认 algoum-mcp 服务已连接。

GitHub Copilot CLI

将服务添加到 ~/.copilot/mcp-config.json：

{
  "mcpServers": {
    "algoum-mcp": {
      "type": "http",
      "url": "https://api.algoum.de/v1/mcp",
      "headers": { "Authorization": "Bearer <your key>" },
      "tools": ["*"]
    }
  }
}

在 CLI 中运行 /mcp，查看 algoum-mcp 是否已连接。该文件会保留在你的本机上。

APM（Agent Package Manager）

APM 会为你选择的助手安装服务。在项目中运行它。它会从你在步骤 1 中导出的环境变量中读取密钥，因此密钥不会写入任何文件：

apm marketplace add fi4all/algoum-mcp
apm install algoum-mcp@algoum-marketplace --target vscode

将 vscode 替换为你的助手，例如 copilot、claude 或 cursor。apm targets 会列出所有受支持的助手。不带 --target 时，APM 需要项目中已有对应的助手文件夹。

链接

• algoum 门户
• API 参考
• MCP Registry 条目
• Glama 列表
• 联系我们 – 提出问题、反馈意见，以及分享你希望我们接下来推出的内容