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 Server Guide
• Octagon Claude Plugin Guide
• Octagon Agents Guide

此 MCP 伺服器也直接向 MCP 客戶端公開即時文件語料庫。文件存取是從位於 https://octagonai.co/docs/llms.txt 的公開 Octagon 文件 LLM 入口點擷取；它不會使用或傳輸 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 和外掛文件，並附上來源網址和選用的片段。

參數

• query（字串，必要）：搜尋查詢。
• section（字串，選用）：按文件章節篩選。
• source（docs、site 或 all，選用）：預設為文件語料庫。
• limit（數字，選用）：要回傳的最大結果數。
• includeSnippets（布林值，選用）：在結果中包含匹配的片段。

範例：

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

按標題、網址、路徑或目錄 ID 讀取一個文件頁面或章節，並以 Markdown 格式呈現。

參數

• target（字串，必要）：文件標題、網址、路徑或目錄 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 對話 ID，用於繼續先前的 octagon-agent 執行緒。在第一輪時省略此項。
• 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.

更多範例：

• "Amazon 在 2023 年第四季的營收和淨利數字是多少？"
• "分析 Tesla 過去 3 年的研發支出趨勢。"
• "NVIDIA 的 CEO 在最新的財報電話會議中，針對 AI 晶片需求提供了什麼樣的指引？"
• "比較前 5 大半導體公司的本益比、股價營收比和 EV/EBITDA 比率。"
• "Anthropic 最新一輪融資的規模、估值和主要投資者是誰？"
• "Andreessen Horowitz 在過去 12 個月內對 AI 新創公司進行了多少筆投資？"
• "NVIDIA 股票在過去一週的最新新聞文章有哪些？"

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/ 擷取所有資料欄位"
• "研究 Apple 的隱私權變更對數位廣告公司營收和利潤的財務影響"
• "擷取 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 - 全面的研究與網頁爬取功能

---

⭐ 如果這個儲存庫對您有幫助，請給它一顆星！