Octagon MCP Server

Octagon：公共与预测市场情报 MCP

Octagon MCP 服务器通过与 Octagon 市场情报 API 集成，提供专业的 AI 驱动金融研究与分析，使用户能够在 Claude Desktop 及其他主流 MCP 客户端中分析并提取来自公开文件、财报电话会议、财务指标、股票与加密货币数据、股票新闻以及预测市场新闻与研究的洞察。

工具

✅ octagon-agent 统筹广泛的市场情报分析

• 公开市场洞察：SEC 文件（10-K、10-Q、20-F、8-K、S-1、13-F、DEF 14A）、财报电话会议记录
• 股票与加密货币市场数据：股票交易、加密货币交易数据、新闻、新闻稿、所有权与持仓

✅ octagon-deep-research-agent 用于全面的深度研究

• 针对投资研究问题的多源综合
• 最适合最新的跨来源主题分析

✅ 预测市场研究工具

• octagon-prediction-markets-agent 用于获取每个预测市场的最新研究报告
• prediction_markets_history 用于结构化的历史市场数据检索

✅ 实时 Octagon 文档访问

• octagon-docs-search、octagon-docs-read、octagon-docs-list 和 octagon-docs-refresh
• 用于 octagon-docs://catalog、octagon-docs://status 和 octagon-docs://page/{target} 的 MCP 资源

获取您的 Octagon API 密钥

要使用 Octagon MCP，您需要：

1. 在 Octagon 注册一个免费账户
2. 登录后，从左侧菜单导航至 API Keys
3. 生成一个新的 API 密钥
4. 在配置中将此 API 密钥用作 OCTAGON_API_KEY 的值

前提条件

在安装或运行 Octagon MCP 之前，您需要在系统上安装 npx（随 Node.js 和 npm 一起提供）。

Mac (macOS)

1. 安装 Homebrew（如果尚未安装）：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 安装 Node.js（包含 npm 和 npx）：

   brew install node
   

   这将安装最新版本的 Node.js、npm 和 npx。

3. 验证安装：

   node -v
   npm -v
   npx -v
   

Windows

1. 下载 Node.js 安装程序：
   • 前往 https://nodejs.org/ 并下载适用于 Windows 的 LTS 版本。
2. 运行安装程序并按照提示操作。这将安装 Node.js、npm 和 npx。
3. 验证安装： 打开命令提示符并运行：

   node -v
   npm -v
   npx -v
   

如果您看到所有三个工具的版本号，即可继续执行下面的安装步骤。

安装

在 Claude Desktop 上运行

要为 Claude Desktop 配置 Octagon MCP：

1. 打开 Claude Desktop
2. 前往 Settings > Developer > Edit Config
3. 将以下内容添加到您的 claude_desktop_config.json（将 your-octagon-api-key 替换为您的 Octagon API 密钥）：

{
  "mcpServers": {
    "octagon-mcp-server": {
      "command": "npx",
      "args": ["-y", "octagon-mcp@latest"],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

4. 重启 Claude 以使更改生效

在 Cursor 上运行

配置 Cursor Desktop 🖥️ 注意：需要 Cursor 版本 0.45.6+

要在 Cursor 中配置 Octagon MCP：

1. 打开 Cursor Settings
2. 前往 Features > MCP Servers
3. 点击 "+ Add New MCP Server"
4. 输入以下内容：
   • 名称："octagon-mcp"（或您偏好的名称）
   • 类型："command"
   • 命令：env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

如果您使用的是 Windows 且遇到问题，请尝试 cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp"

将 your-octagon-api-key 替换为您的 Octagon API 密钥。

添加后，刷新 MCP 服务器列表以查看新工具。Composer Agent 将在适当时自动使用 Octagon MCP，但您也可以通过描述您的投资研究需求来显式请求。通过 Command+L (Mac) 访问 Composer，选择提交按钮旁边的 "Agent"，然后输入您的查询。

使用 npx 运行

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

手动安装

npm install -g octagon-mcp

文档

有关使用 Octagon 代理的全面文档，请访问我们的官方文档： https://octagonai.co/docs/

文档包括：

• 详细的 API 参考
• 特定代理的查询指南
• 示例和用例
• 投资研究的最佳实践

有关最新的托管 MCP 客户端设置指南，请参阅：

• Octagon MCP 服务器指南
• Octagon Claude 插件指南
• Octagon 代理指南

此 MCP 服务器还直接将实时文档语料库暴露给 MCP 客户端。文档访问从公共 Octagon 文档 LLM 入口点 https://octagonai.co/docs/llms.txt 获取；它不使用或传输 OCTAGON_API_KEY。

可用工具

MCP 服务器目前公开以下工具：

文档工具

这些工具在 MCP 会话中公开实时 Octagon 文档。它们甚至在配置 OCTAGON_API_KEY 之前就能工作，这使其对于设置、故障排除以及发现正确的 Octagon 代理或 API 工作流程非常有用。

octagon-docs-list

列出 Octagon 文档语料库中的实时文档部分和页面。

参数

• section（字符串，可选）：按文档部分筛选。
• source（docs、site 或 all，可选）：默认为文档语料库。
• limit（数字，可选）：返回的最大条目数。

octagon-docs-search

搜索 Octagon API、代理、MCP 和插件文档，并返回源 URL 和可选的片段。

参数

• query（字符串，必需）：搜索查询。
• section（字符串，可选）：按文档部分筛选。
• source（docs、site 或 all，可选）：默认为文档语料库。
• limit（数字，可选）：返回的最大结果数。
• includeSnippets（布尔值，可选）：在结果中包含匹配的片段。

示例：

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

按标题、URL、路径或目录 ID 以 Markdown 格式读取一个文档页面或部分。

参数

• target（字符串，必需）：文档标题、URL、路径或目录 ID。
• source（docs、site 或 all，可选）：默认为文档语料库。
• maxChars（数字，可选）：返回的最大 Markdown 字符数。
• preferCachedContent（布尔值，可选）：在可用时使用索引的文档语料库。

示例：

Read the Octagon MCP server guide.

octagon-docs-refresh

从实时 LLM 友好文档端点刷新内存中的文档目录。

参数

• includeSite（布尔值，可选）：同时刷新更广泛的 https://octagonai.co/llms.txt 站点索引。

文档资源

支持 MCP 资源的客户端还可以浏览：

• octagon-docs://catalog：标准化的实时文档目录。
• octagon-docs://status：缓存状态、源端点和刷新元数据。
• octagon-docs://page/{target}：一个文档页面或部分的 Markdown 格式。

octagon-agent

统筹公共和私人市场情报分析。

参数

• prompt（字符串，必需）：自然语言研究请求。
• conversation（字符串，可选）：用于继续先前 octagon-agent 线程的现有 Octagon 对话 ID。在第一轮中省略此项。
• newConversation（布尔值，可选）：如果为 true，则为活动会话/线程锚点启动一个新的 Octagon 线程。建议在 Claude Desktop 等顶层主机中全新可见聊天的第一轮使用。

线程化使用

octagon-agent 是唯一转发 Octagon 对话线程的 MCP 工具。它是一个有状态工具，并期望会话连续性。MCP 按以下顺序解析会话/线程状态：

1. 当传输实际提供时，为 MCP 传输会话标识存储的对话
2. 为服务器管理的默认 stdio 会话存储的对话
3. 显式的 conversation 仍可为该调用覆盖活动会话对话

此包当前作为 stdio MCP 服务器运行。在 stdio 模式下，服务器会自动建立一个进程本地会话，以实现跨调用的连续性。因此，大多数本地主机（如 Claude Desktop 或 Cursor）可以使用 octagon-agent，而无需为基本的后续行为提供任何额外的线程字段。

当顶层主机知道某个调用是新可见聊天的第一轮时，它应传递 newConversation: true。这会在调用前显式清除活动 MCP 会话锚点的任何已存储 Octagon 线程，从而防止当 stdio 主机在多个可见聊天中重用相同的长期 MCP 进程时出现陈旧的连续性。

这意味着您可以使用以下任何模式：

1. 第一次调用：仅发送 prompt
2. 让 MCP 主机保留传输会话连续性或依赖默认的 stdio 会话
3. 第二次调用：要么
   • 在同一 MCP 会话中发送新的 prompt，要么
   • 继续使用相同的 stdio MCP 进程，要么
   • 显式传递先前的 conversation

传输会话标识是符合标准的有状态 MCP 传输的规范连续性原语。对于本地 stdio 使用，服务器管理的进程会话提供默认连续性。

会话标识和 Octagon 对话标识是不同的概念：

• MCP 会话标识控制跨工具调用的服务器端连续性
• Octagon conversation 控制该会话内的活动 Octagon 线程

MCP 结果将答案保留在 content 中，并在 structuredContent 中为编排器返回结构化元数据：

{
  "model": "octagon-agent",
  "text": "Which stock would you like the latest price for?",
  "conversation": "conv_123",
  "responseId": "resp_123",
  "followUp": {
    "required": true,
    "inputTemplate": "<ticker or company name>",
    "instructions": "Reply with just the missing detail and reuse the conversation value from this response."
  }
}

显式传递示例：

{
  "prompt": "AAPL",
  "conversation": "conv_123"
}

新可见聊天示例：

{
  "prompt": "Analyze Apple",
  "newConversation": true
}

显式刷新示例：

{
  "prompt": "Start a fresh Octagon thread for this chat",
  "newConversation": true
}

有状态工具策略

• octagon-agent：有状态，使用可用的连续性锚点。在 stdio 主机中，除非您提供显式的 conversation，否则默认为服务器管理的进程会话
• 其他 MCP 工具：无状态，可在没有会话连续性的情况下运行

示例：

Compare NVIDIA and AMD on latest quarterly revenue growth, margins, and management commentary.

更多示例：

• "亚马逊 2023 年第四季度的收入和净利润数据是多少？"
• "分析特斯拉过去 3 年的研发支出趋势。"
• "英伟达 CEO 在最新的财报电话会议中就 AI 芯片需求提供了什么指引？"
• "比较前 5 家半导体公司的市盈率、市销率和 EV/EBITDA 比率。"
• "Anthropic 最新一轮融资的规模、估值和关键投资者是什么？"
• "安德森·霍洛维茨在过去 12 个月中对 AI 初创公司进行了多少笔投资？"
• "过去一周英伟达股票的最新新闻文章有哪些？"

octagon-deep-research-agent

执行全面的多源深度研究与综合。

参数

• prompt（字符串，必需）：自然语言研究请求。

示例：

Research the impact of lower interest rates on late-stage private software valuations over the next 12 months.

更多示例：

• "从 zillow.com/san-francisco-ca/ 提取所有数据字段"
• "研究苹果隐私变更对数字广告公司收入和利润的财务影响"
• "检索 2023 年的历史比特币价格数据并分析价格波动趋势"
• "分析电动汽车充电基础设施市场的竞争动态"

octagon-prediction-markets-agent

为 Kalshi 预测市场事件生成研究报告。

参数

• prompt（字符串，必需）：自然语言研究请求。
• cache（布尔值，可选）：控制代理变体路由。
  • 省略：prediction-markets-agent
  • false：prediction-markets-agent:refresh
  • true：prediction-markets-agent:cache

示例：

Generate a report for the Kalshi market https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

prediction_markets_history

获取预测市场事件代码的历史数据，支持可选的分页和时间筛选。

参数

• event_ticker（字符串，必需）
• limit（数字，可选）
• cursor（字符串，可选）
• captured_from（字符串，可选）
• captured_to（字符串，可选）
• include_analysis（布尔值，可选；为 true 时，请求分析列）

示例：

Fetch historical data for the Kalshi event https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

故障排除

1. API 密钥问题：确保您的 Octagon API 密钥在环境或配置文件中正确设置。
2. 连接问题：确保与 Octagon API 的连接正常工作。
3. 速率限制：如果遇到速率限制错误，请降低请求频率。

许可证

MIT

独立的专业 MCP 服务器

虽然此服务器结合了我们所有的专业代理提供全面的市场情报，但您也可以针对特定用例使用我们独立的 MCP 服务器：

研究工具

• Octagon 深度研究 MCP - 全面的研究和网页抓取能力

---

⭐ 如果您觉得此仓库有帮助，请给它加星！