使用说明

项目简介

Octagon MCP服务器是一个实现了 Model Context Protocol (MCP) 的应用后端，专注于为LLM客户端提供投资研究领域的专业能力。它集成了Octagon API，提供了一系列用于金融数据分析、市场情报挖掘和公司信息查询的工具，旨在帮助用户更高效地进行投资研究和决策分析。

主要功能点

丰富的投资研究工具: 提供针对公开市场和私募市场的多种AI агенты，涵盖SEC文件分析、财报解读、盈利电话会议记录分析、财务指标计算、股票市场数据查询、私募公司研究、风险投资和并购交易分析等。
便捷的API接口: 所有工具均通过统一的 'prompt' 参数接受自然语言查询，简化了用户操作。
流式响应支持: 支持流式传输，提供更快速的实时响应体验。
易于集成: 可以通过标准MCP协议与各类LLM客户端（如Cursor, Claude Desktop, Windsurf等）无缝集成。

安装步骤

安装 octagon-mcp 包: 打开终端，根据您的环境选择以下命令进行安装：
- 使用 'npx' 临时运行 (推荐)：
```
npx -y octagon-mcp
```
- 全局安装 (需要 npm 环境):
```
npm install -g octagon-mcp
```
配置 Octagon API 密钥: 您需要拥有一个 Octagon API 密钥才能使用此服务器。
- 访问 Octagon官网注册账号。
- 登录后，在 Settings → API Keys 页面创建新的 API 密钥。
- 将 API 密钥设置为环境变量 'OCTAGON_API_KEY'。例如，在运行命令前添加 'env OCTAGON_API_KEY=YOUR_API_KEY'。

服务器配置

为了让MCP客户端（如Cursor, Claude Desktop, Windsurf）连接到 Octagon MCP 服务器，您需要配置服务器的启动命令。以下是针对不同客户端的配置示例：

Cursor 配置:

在 Cursor 设置中，添加新的 MCP 服务器，类型选择 "command"，命令 (Command) 填写以下内容 (请替换 'YOUR_API_KEY' 为您的实际 API 密钥)：

{
  "name": "octagon-mcp",
  "type": "command",
  "command": "env OCTAGON_API_KEY=YOUR_API_KEY npx -y octagon-mcp"
}

Claude Desktop 配置:

在 Claude Desktop 的 'claude_desktop_config.json' 文件中，'mcpServers' 字段下添加如下配置 (请替换 'YOUR_API_KEY' 为您的实际 API 密钥)：

{
  "mcpServers": {
    "octagon": {
      "command": "env",
      "args": ["OCTAGON_API_KEY=YOUR_API_KEY", "npx", "-y", "octagon-mcp"]
    }
  }
}

Windsurf 配置:

在 Windsurf 的 './codeium/windsurf/model_config.json' 文件中，'mcpServers' 字段下添加如下配置 (请替换 'YOUR_API_KEY' 为您的实际 API 密钥)：

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

注意: 'command' 字段指定了启动服务器的命令，'args' 字段是命令的参数，'env' 字段用于设置环境变量。请确保 'YOUR_API_KEY' 替换为您在 Octagon 官网申请的 API 密钥。

基本使用方法

配置完成后，在支持 MCP 服务器的 LLM 客户端中，即可通过自然语言指令调用 Octagon MCP 服务器提供的工具。例如，在 Cursor 中，可以使用 Command+L 打开 Composer，选择 "Agent" 并输入您的投资研究问题，Composer 将自动或根据您的指示调用 Octagon MCP 服务器进行处理。

例如，您可以提问：

"苹果公司最新的10-Q文件中，毛利率是多少？"
"英伟达CEO在最近的财报电话会议中关于AI芯片需求说了什么？"
"分析特斯拉过去3年的研发支出趋势。"

服务器将返回相应的投资研究结果。

关键词