octagon-mcp-server

如果你经常需要分析公司财报、追踪股市动态，或者研究某个行业的投资价值，你一定知道这个过程有多繁琐。打开SEC官网查找10-K文件，去财报电话会实录里翻找管理层的只言片语，再用Excel计算各种财务比率……这套流程不仅耗时，而且容易遗漏关键信息。

现在，有一款开源工具可以让AI助手直接替你完成这些工作。你只需要在Claude Desktop或者其他支持MCP协议的客户端里输入一句自然语言指令，比如“对比英伟达和AMD最新季度的营收增长率和毛利率”，octagon-mcp-server就会自动调用金融数据接口，把分析结果送到你面前。

这就是今天要介绍的项目：一个完全免费的MCP服务器，专门用于分析公开财报、业绩会实录、市场数据、私募交易信息，甚至能进行深度网络研究。它把复杂的金融数据查询变成了简单的对话。

项目基本信息

一、项目介绍

octagon-mcp-server是一个充当“翻译官”角色的中间件。它遵循MCP（Model Context Protocol）协议，连接AI客户端（如Claude Desktop）和Octagon市场情报API。简单来说，它让AI能听懂金融数据相关的指令，并且有能力去获取、分析这些数据。

这个服务器提供了几个核心的“工具”供AI调用：

octagon-agent：这是最常用的综合性分析工具。你可以用它查询上市公司的财务数据、SEC文件内容、股价走势，也可以了解私有公司的融资轮次、估值和投资者信息。它覆盖了从公开市场到私募市场的广泛数据。

octagon-deep-research-agent：当需要做深度的、跨多个信息源的研究时，这个工具就派上用场了。比如“分析低利率环境对后期私有软件公司估值未来12个月的影响”，它会整合财报、新闻、研报等多方面信息，生成一份综合性的研究报告。

prediction-markets-agent：专门用于分析Kalshi等预测市场上的事件。比如你想知道某个政治事件或经济指标的未来走向概率，它可以生成详细的研究报告。

prediction_markets_history：用于获取预测市场事件的历史数据，支持分页和时间范围筛选。

这些工具组合在一起，等于给AI装上了一套专业的金融研究工具箱。你不需要学习复杂的查询语法，也不需要自己搭建数据管道，只要会提问就行。

二、核心优势

完全免费的开源方案

在金融数据领域，高质量的API往往价格不菲。octagon-mcp-server采用MIT许可证，代码完全开放，你可以自由使用、修改，甚至集成到自己的项目中。这对于个人开发者、研究机构或者初创团队来说，极大地降低了获取金融数据的门槛。

基于自然语言的交互方式

传统的金融数据终端需要记忆大量的代码和命令，而octagon-mcp-server让你直接用日常语言提问。这种体验上的差异是巨大的：你可以像和一位研究员对话一样，让AI去挖掘数据背后的信息。

覆盖多种市场的数据广度

它不仅包含上市公司数据（SEC文件、财报电话会、财务指标、股票数据），还覆盖了私有市场信息（公司档案、融资轮次、投资者、债务信息）和预测市场数据。这种多维度的数据组合，对于全面的投资研究非常有价值。

与主流AI客户端无缝集成

无论是Claude Desktop、Cursor编辑器，还是其他支持MCP协议的客户端，都可以通过简单的配置接入。这意味着你可以在自己习惯的工作环境中直接使用这些金融分析能力。

三、适用场景

个人投资者的研究助手

如果你平时会自己研究股票，可以用它快速获取关键财务数据。比如直接问“茅台近五年的净资产收益率趋势如何”，或者“特斯拉最新财报中关于Cybertruck的产能指引是什么”，省去翻找财报的时间。

量化策略的辅助验证

量化交易者在开发策略时，可以用它来快速获取和验证基本面因子。例如查询“过去10年标普500成分股中，营收连续增长超过5年的公司名单”，它能从海量数据中帮你筛选出来。

财经内容创作者的素材来源

写深度分析文章需要大量数据和案例支持。你可以用octagon-deep-research-agent来生成特定主题的背景研究报告，比如“人工智能芯片市场的竞争格局和主要玩家的市场份额变化”，为你的内容提供扎实的数据基础。

创业公司的市场分析

研究竞争对手或潜在投资标的时，可以查询私有公司的融资历史、主要投资者以及估值变化。例如“列出2025年获得红杉资本投资的生成式AI创业公司及其融资轮次”，这些信息对于商业决策很有参考价值。

四、安装教程

在开始之前，你需要先做两件事：获取Octagon API密钥，并确保系统安装了Node.js环境。

获取API密钥

访问Octagon官网（octagonai.co）注册一个免费账户。登录后，在左侧菜单中找到API Keys页面，生成一个新的密钥。记下这个密钥，后续配置时会用到。

安装Node.js环境

Mac用户可以通过Homebrew安装：

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

Windows用户可以直接从nodejs.org下载LTS版本的安装包，按提示完成安装。

安装完成后，验证一下：

node -v
npm -v
npx -v

如果都能正常显示版本号，说明环境准备好了。

配置到Claude Desktop

这是最常用的使用方式。首先确保你已经安装了Claude Desktop应用。然后找到Claude的配置文件：

• 打开Claude Desktop
• 进入 Settings > Developer > Edit Config

这会打开一个claude_desktop_config.json文件。将以下内容添加进去，记得替换成你自己的API密钥：

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

保存文件后，完全退出并重启Claude Desktop，配置就会生效。

配置到Cursor编辑器

如果你使用Cursor作为代码编辑器，也可以集成这个MCP服务器。前提是Cursor版本在0.45.6以上。

打开Cursor Settings，进入 Features > MCP Servers，点击“+ Add New MCP Server”。填写如下信息：

• Name: octagon-mcp (可以自己命名)
• Type: command
• 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"

添加后，刷新MCP服务器列表，就能看到新添加的工具了。

五、使用示例

配置完成后，你就可以在Claude Desktop或Cursor中直接使用了。下面是一些实际的使用案例。

查询公司财务数据

你可以在对话框中输入：

“What was Amazon's revenue and net income figures in Q4 2023?”

AI会调用octagon-agent工具，返回具体的数字，可能还会附上同比变化或环比趋势的分析。

分析管理层评论

“What guidance did NVIDIA's CEO provide regarding AI chip demand in their latest earnings call?”

这个查询会触发对最新财报电话会实录的检索，AI会从管理层的发言中提取关于AI芯片需求的前瞻性指引。

对比多家公司估值

“Compare the price-to-earnings, price-to-sales, and EV/EBITDA ratios for the top 5 semiconductor companies.”

AI会获取这五家半导体公司的相应估值指标，并以表格或对比列表的形式呈现。

研究私有市场动态

“What was Anthropic's latest funding round size, valuation, and key investors?”

这个查询会从私有市场数据集中检索Anthropic的最新融资信息，告诉你融资金额、估值和参与的投资机构。

进行深度主题研究

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

这是octagon-deep-research-agent的典型应用场景。AI会综合多方面的信息源，生成一份结构化的研究报告，可能包括历史数据分析、当前市场观点和未来情景推演。

分析预测市场

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

AI会调用prediction-markets-agent，针对这个比特币价格范围的预测市场事件生成一份研究报告，帮助你看懂当前市场对各个价位的概率分布。

六、常见问题

API Key无效或认证失败

请仔细检查配置文件中OCTAGON_API_KEY的值是否正确，注意不要有多余的空格或引号。如果是从网页复制粘贴的密钥，确保没有复制到额外的字符。另外，确认一下你的Octagon账户处于活跃状态，并且没有超出免费调用限额。

查询没有返回结果

可能是查询表述不够清晰。尝试更具体地描述你的需求，比如指明时间范围、公司名称的标准写法（如"Apple Inc."而不是"苹果"）。如果查询私有公司信息，请确认该公司在Octagon的数据库中存在。

遇到速率限制错误

免费账户通常有调用频率限制。如果你遇到速率限制的提示，可以适当降低查询的频率，或者将多个问题合并成一次查询。例如，与其分五次问五家公司的营收，不如一次问“请列出英伟达、AMD、英特尔、高通、博通最新季度的营收数据”。

在Windows上配置Cursor时命令不生效

Windows的cmd对环境变量的设置方式有所不同。请使用文档中提供的备选命令：

cmd /c "set OCTAGON_API_KEY=YOUR_API_KEY && npx -y octagon-mcp"

注意将YOUR_API_KEY替换成实际的密钥。如果还是不行，可以尝试在PowerShell中运行，或者重启Cursor后再试。

Claude Desktop看不到新工具

配置修改后，必须完全退出Claude Desktop应用（不仅仅是关闭窗口，要从系统托盘或任务栏彻底退出），然后重新启动。如果仍然看不到，检查一下JSON配置文件的语法是否正确，比如大括号、逗号是否匹配。

七、总结

octagon-mcp-server巧妙地连接了AI语言模型和专业的金融数据世界。它把复杂的API查询封装成了简单的自然语言对话，让数据分析的门槛大大降低。

对于那些需要频繁处理财务数据、公司信息或者市场趋势的人来说，这个工具可以实实在在地节省时间。更重要的是，它是完全开源的，这意味着你不用为使用它而支付高昂的软件授权费。你可以把它集成到自己的研究流程里，甚至基于它开发更定制化的应用。

当然，目前它提供的免费API Key可能会有调用次数限制，而且金融数据的准确性依赖于Octagon的数据源。但对于大多数个人研究、学习和轻量级分析场景来说，它已经足够强大。如果你对金融分析和AI的结合感兴趣，不妨亲自尝试一下这个开源项目。