Octagon: MCP for Market Data

由 Modl 托管，Modl 团队所做的任何提交或更改均旨在确保兼容性

Octagon：市场数据 MCP

Octagon MCP 服务通过集成 Octagon Market Intelligence API，提供专业的 AI 金融研究与分析功能，让用户能够在 Claude Desktop 和其他热门 MCP 客户端中轻松分析并提取公共文件、财报电话会议文字记录、财务指标、股票市场数据以及大量私募市场交易的详细见解。

功能

✅ 专注于公开市场数据的专业 AI Agent

• SEC 文件分析与数据提取（8000 多家上市公司的 10-K、10-Q、8-K、20-F、S-1）
• 财报电话会议文字记录分析（10 年历史数据及当前数据）
• 财务指标与比率分析（10 年历史数据及当前数据）
• 股票市场数据访问（超过 10,000 个活跃代码，包含每日历史数据及当前数据）

✅ 专注于私募市场数据的专业 AI Agent

• 私营公司研究（300 多万家公司）
• 融资轮次与风险投资研究（50 多万笔交易）
• 并购与 IPO 交易研究（200 多万笔交易）
• 债务交易研究（100 多万笔交易）

✅ 专注于深度研究的专业 AI Agent

• 网页抓取功能（json、csv、python 脚本）
• 全面的深度研究工具

获取 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 设置
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”，然后输入查询。

在 Windsurf 上运行

将以下内容添加到 ./codeium/windsurf/model_config.json：

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

使用 npx 运行

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

手动安装

npm install -g octagon-mcp

文档

如需了解 Octagon Agent 的全面使用文档，请访问我们的官方文档： https://docs.octagonagents.com

文档包括：

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

可用工具

每个工具都使用一个 prompt 参数来接收自然语言查询。请在提示词中包含所有相关细节。

公开市场情报

octagon-sec-agent

从 SEC 文件中提取信息。

示例：

What was Apple's gross margin percentage from their latest 10-Q filing?

octagon-transcripts-agent

分析财报电话会议文字记录。

示例：

What did NVIDIA's CEO say about AI chip demand in their latest earnings call?

octagon-financials-agent

获取财务指标和比率。

示例：

Calculate the price-to-earnings ratio for Tesla over the last 4 quarters

octagon-stock-data-agent

访问股票市场数据。

示例：

How has Apple's stock performed compared to the S&P 500 over the last 6 months?

私募市场情报

octagon-companies-agent

研究私营公司信息。

示例：

What is the employee count and funding history for Anthropic?

octagon-funding-agent

研究初创公司融资轮次和风险投资。

示例：

What was OpenAI's latest funding round size, valuation, and key investors?

octagon-deals-agent

研究并购和 IPO 交易。

示例：

What was the acquisition price when Microsoft acquired GitHub?

octagon-investors-agent

用于查询投资者信息的专用数据库 Agent。

示例：

What is the latest investment criteria of Insight Partners?

octagon-debts-agent

用于分析私人债务、借款人和贷款人的专用数据库 Agent。

示例：

List all the debt activities from borrower American Tower

其他工具

octagon-scraper-agent

从任何公开网站提取数据。

示例：

Extract property prices and square footage data from zillow.com/san-francisco-ca/

octagon-deep-research-agent

针对任何主题开展全面研究。

示例：

Research the financial impact of Apple's privacy changes on digital advertising companies' revenue and margins

示例查询

1. “Amazon 在 2023 年第四季度的营收和净利润分别是多少？”
2. “分析 Tesla 过去 3 年的研发支出趋势。”
3. “NVIDIA 的 CEO 在最近一次财报电话会议上对 AI 芯片需求作出了什么展望？”
4. “比较排名前 5 的半导体公司的市盈率、市销率和 EV/EBITDA 比率。”
5. “Anthropic 最近一轮融资的规模、估值和主要投资者是什么？”
6. “提取 zillow.com/san-francisco-ca/ 上的所有数据字段”
7. “研究 Apple 隐私政策变化对数字广告公司营收和利润率的财务影响”
8. “汇总贷款机构 ING Group 在 2024 年第四季度的所有债务活动”
9. “Andreessen Horowitz 在过去 12 个月中向 AI 初创公司进行了多少笔投资？”

故障排除

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

安装

使用 npx 运行

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

手动安装

npm install -g octagon-mcp

许可证

MIT

---

⭐ 如果觉得这个仓库有帮助，请点个 Star！