AI导哈

金融研究分析服务

Octagon MCP服务器提供AI驱动的金融研究和分析服务，集成市场情报API，支持从公开文件、财报电话会议、金融指标、股票与加密货币数据、新闻及预测市场研究中提取洞察。

  • by OctagonAI
  • TypeScript
  • 本地部署
  • 147 星标
  • 更新于
在 GitHub 查看 OctagonAI/octagon-mcp-server

使用说明

Octagon:MCP公共和预测市场情报

Octagon MCP服务器通过与Octagon Market Intelligence API集成，提供专业的人工智能金融研究和分析，使用户能够在Claude Desktop和其他受欢迎的MCP客户中分析和提取公开文件、财报电话、财务指标、股票和加密数据、股票新闻以及预测市场新闻和研究的见解。

工具

✅ octagon-agent 精心策划广泛的市场情报分析

  • 公开市场见解：美国证券交易委员会文件（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-docs-search, octagon-docs-read, octagon-docs-list，以及 octagon-docs-refresh
  • MCP资源 octagon-docs://catalog, octagon-docs://status，以及 octagon-docs://page/{target}

获取八角形API密钥

要使用Octagon MCP，您需要：

  1. 注册一个免费帐户 八边形
  2. 登录后，从左侧菜单导航到 API密钥
  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

视窗

  1. 下载Node.js安装程序：
  2. 运行安装程序 并按照提示进行操作。这将安装Node.js、npm和npx。
  3. 验证安装： 打开命令提示符并运行：
    node -v
npm -v
npx -v

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

安装

在Claude桌面上运行

要为Claude Desktop配置八角形MCP，请执行以下操作：

  1. 打开克劳德桌面
  2. 前往“设置”>“开发人员”>“编辑配置”
  3. 将以下内容添加到您的 claude_desktop_config.json （替换 your-octagon-api-key 使用八角形API密钥）：
{
  "mcpServers": {
    "octagon-mcp-server": {
      "command": "npx",
      "args": ["-y", "octagon-mcp@latest"],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
  1. 重新启动Claude以使更改生效

在游标上运行

配置光标桌面🖥️ 注意：需要游标版本0.45.6+

要在游标中配置八角形MCP：

  1. 打开光标设置
  2. 转到功能>MCP服务器
  3. 点击“+添加新MCP服务器”
  4. 输入以下内容：
    • 名称：“八角形mcp”（或您的首选名称）
    • 类型：“命令”
    • 命令： 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 使用八角形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客户端设置指南，请参阅：

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

可用工具

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

文档工具

这些工具在MCP会话中公开实时八角文档。他们甚至在以前工作过 OCTAGON_API_KEY 已配置，这使它们对于设置、故障排除和发现正确的八角形代理或API工作流非常有用。

octagon-docs-list

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

参数

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

octagon-docs-search

使用源URL和可选片段搜索八角形API、代理、MCP和插件文档。

参数

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

例子：

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 （boolean，可选）：也刷新更广泛的 https://octagonai.co/llms.txt 网站索引。

文献资源

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

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

octagon-agent

协调公共和私人市场情报分析。

参数

  • prompt （string，必填）：自然语言研究请求。
  • conversation （字符串，可选）：现有的八角对话ID，用于继续之前的对话 octagon-agent 线。在第一个转弯时忽略这一点。
  • newConversation （布尔值，可选）：如果 true，为活动会话/线程锚点启动一个新的八角线程。推荐用于顶级主机（如Claude Desktop）中全新可见聊天的第一轮。

线程使用

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

  1. 存储MCP传输会话标识的对话，当传输实际提供它时
  2. 为服务器管理的默认值存储对话 stdio 会话
  3. 明确的 conversation 仍然可以覆盖该呼叫的活动会话对话

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

当顶层主机知道呼叫是新可见聊天的第一轮时，它应该通过 newConversation: true这会在调用之前显式清除活动MCP会话锚点的任何存储的八角线程，从而防止在以下情况下出现过时的连续性 stdio 主机在多个可见聊天中重用相同的长期MCP进程。

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

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

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

会话身份和八角对话身份是不同的概念：

  • MCP会话标识控制跨工具调用的服务器端连续性
  • 八边形 conversation 控制该会话中的活动八角线程

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：stateful，使用可用的连续性锚点。在 stdio 主机，默认为服务器管理的进程会话，除非您提供明确的 conversation
  • 其他MCP工具：无状态，可能在没有会话连续性的情况下运行

例子：

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

更多示例：

  • “亚马逊2023年第四季度的收入和净收入是多少？”
  • “分析特斯拉过去3年的研发支出趋势。”
  • “NVIDIA的首席执行官在他们最新的电话财报会议中就人工智能芯片需求提供了什么指导？”
  • “比较前5家半导体公司的市盈率、市盈率和EV/EBITDA比率。”
  • Anthropic的最新一轮融资规模、估值和主要投资者是多少
  • “在过去的12个月里，Andreessen Horowitz对人工智能初创公司进行了多少投资？”
  • “过去一周NVIDIA股票的最新新闻报道是什么？”

octagon-deep-research-agent

进行全面的多源深度研究和综合。

参数

  • prompt （string，必填）：自然语言研究请求。

例子：

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

更多示例：

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

octagon-prediction-markets-agent

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

参数

  • prompt （string，必填）：自然语言研究请求。
  • 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关键问题：确保在环境或配置文件中正确设置了八角形API密钥。
  2. 连接问题：确保与八角形API的连接正常工作。
  3. 速率限制：如果遇到限速错误，请降低请求频率。

许可证

麻省理工学院

单个专用MCP服务器

虽然该服务器结合我们所有的专业代理提供全面的市场情报，但您也可以将我们的个人MCP服务器用于特定用例：

研究工具

⭐ 如果你觉得这个repo有用，请将其标记为星号！

相关 MCP