Octagon

Octagon: MCP cho Thông tin Thị trường Công khai & Dự đoán

Máy chủ Octagon MCP cung cấp nghiên cứu và phân tích tài chính chuyên biệt hỗ trợ bởi AI bằng cách tích hợp với API Thông tin Thị trường Octagon, cho phép người dùng phân tích và trích xuất thông tin chi tiết từ hồ sơ công khai, cuộc gọi thu nhập, chỉ số tài chính, dữ liệu cổ phiếu & tiền điện tử, tin tức cổ phiếu, và tin tức & nghiên cứu thị trường dự đoán trong Claude Desktop và các ứng dụng khách MCP phổ biến khác.

Công cụ

✅ octagon-agent điều phối phân tích thông tin thị trường rộng

• Thông tin thị trường công khai: hồ sơ SEC (10-K, 10-Q, 20-F, 8-K, S-1, 13-F, DEF 14A), bản ghi cuộc gọi thu nhập
• Dữ liệu thị trường cổ phiếu & tiền điện tử: giao dịch cổ phiếu, dữ liệu giao dịch tiền điện tử, tin tức, thông cáo báo chí, quyền sở hữu và nắm giữ

✅ octagon-deep-research-agent cho nghiên cứu sâu toàn diện

• Tổng hợp đa nguồn cho các câu hỏi nghiên cứu đầu tư
• Tốt nhất cho phân tích chuyên đề cập nhật, xuyên nguồn

✅ Công cụ nghiên cứu thị trường dự đoán

• octagon-prediction-markets-agent cho các báo cáo nghiên cứu cập nhật về từng thị trường dự đoán
• prediction_markets_history cho truy xuất dữ liệu thị trường lịch sử có cấu trúc

✅ Truy cập tài liệu Octagon trực tiếp

• octagon-docs-search, octagon-docs-read, octagon-docs-list, và octagon-docs-refresh
• Tài nguyên MCP cho octagon-docs://catalog, octagon-docs://status, và octagon-docs://page/{target}

Lấy Khóa API Octagon của Bạn

Để sử dụng Octagon MCP, bạn cần:

1. Đăng ký tài khoản miễn phí tại Octagon
2. Sau khi đăng nhập, từ menu bên trái, điều hướng đến API Keys
3. Tạo khóa API mới
4. Sử dụng khóa API này trong cấu hình của bạn làm giá trị OCTAGON_API_KEY

Điều kiện tiên quyết

Trước khi cài đặt hoặc chạy Octagon MCP, bạn cần cài đặt npx (đi kèm với Node.js và npm) trên hệ thống của bạn.

Mac (macOS)

1. Cài đặt Homebrew (nếu bạn chưa có):

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

2. Cài đặt Node.js (bao gồm npm và npx):

   brew install node
   

   Thao tác này sẽ cài đặt phiên bản mới nhất của Node.js, npm và npx.

3. Xác minh cài đặt:

   node -v
   npm -v
   npx -v
   

Windows

1. Tải xuống trình cài đặt Node.js:
   • Truy cập https://nodejs.org/ và tải xuống phiên bản LTS cho Windows.
2. Chạy trình cài đặt và làm theo hướng dẫn. Thao tác này sẽ cài đặt Node.js, npm và npx.
3. Xác minh cài đặt: Mở Command Prompt và chạy:

   node -v
   npm -v
   npx -v
   

Nếu bạn thấy số phiên bản cho cả ba, bạn đã sẵn sàng tiến hành các bước cài đặt bên dưới.

Cài đặt

Chạy trên Claude Desktop

Để cấu hình Octagon MCP cho Claude Desktop:

1. Mở Claude Desktop
2. Đi tới Settings > Developer > Edit Config
3. Thêm nội dung sau vào claude_desktop_config.json của bạn (Thay thế your-octagon-api-key bằng khóa API Octagon của bạn):

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

4. Khởi động lại Claude để các thay đổi có hiệu lực

Chạy trên Cursor

Cấu hình Cursor Desktop 🖥️ Lưu ý: Yêu cầu Cursor phiên bản 0.45.6+

Để cấu hình Octagon MCP trong Cursor:

1. Mở Cursor Settings
2. Đi tới Features > MCP Servers
3. Nhấp "+ Add New MCP Server"
4. Nhập thông tin sau:
   • Tên: "octagon-mcp" (hoặc tên bạn muốn)
   • Loại: "command"
   • Lệnh: env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

Nếu bạn đang sử dụng Windows và gặp sự cố, hãy thử cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp"

Thay thế your-octagon-api-key bằng khóa API Octagon của bạn.

Sau khi thêm, làm mới danh sách máy chủ MCP để thấy các công cụ mới. Composer Agent sẽ tự động sử dụng Octagon MCP khi thích hợp, nhưng bạn có thể yêu cầu rõ ràng bằng cách mô tả nhu cầu nghiên cứu đầu tư của mình. Truy cập Composer qua Command+L (Mac), chọn "Agent" bên cạnh nút gửi, và nhập truy vấn của bạn.

Chạy với npx

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

Cài đặt Thủ công

npm install -g octagon-mcp

Tài liệu

Để có tài liệu toàn diện về cách sử dụng các tác nhân Octagon, vui lòng truy cập tài liệu chính thức của chúng tôi tại: https://octagonai.co/docs/

Tài liệu bao gồm:

• Tham chiếu API chi tiết
• Hướng dẫn truy vấn cụ thể cho từng tác nhân
• Ví dụ và trường hợp sử dụng
• Thực tiễn tốt nhất cho nghiên cứu đầu tư

Để biết hướng dẫn thiết lập ứng dụng khách MCP được lưu trữ mới nhất, xem:

• Hướng dẫn Máy chủ Octagon MCP
• Hướng dẫn Plugin Octagon Claude
• Hướng dẫn Tác nhân Octagon

Máy chủ MCP này cũng hiển thị kho tài liệu trực tiếp trực tiếp cho các ứng dụng khách MCP. Truy cập tài liệu được lấy từ điểm vào LLM tài liệu Octagon công khai tại https://octagonai.co/docs/llms.txt; nó không sử dụng hoặc truyền OCTAGON_API_KEY.

Công cụ Khả dụng

Máy chủ MCP hiện hiển thị các công cụ sau:

Công cụ Tài liệu

Các công cụ này hiển thị tài liệu Octagon trực tiếp trong phiên MCP. Chúng hoạt động ngay cả trước khi OCTAGON_API_KEY được cấu hình, điều này hữu ích cho việc thiết lập, khắc phục sự cố và khám phá tác nhân hoặc quy trình API Octagon phù hợp.

octagon-docs-list

Liệt kê các phần và trang tài liệu trực tiếp từ kho tài liệu Octagon.

Tham số

• section (chuỗi, tùy chọn): lọc theo phần tài liệu.
• source (docs, site, hoặc all, tùy chọn): mặc định là kho tài liệu.
• limit (số, tùy chọn): số lượng mục tối đa trả về.

octagon-docs-search

Tìm kiếm tài liệu API, tác nhân, MCP và plugin Octagon với URL nguồn và đoạn trích tùy chọn.

Tham số

• query (chuỗi, bắt buộc): truy vấn tìm kiếm.
• section (chuỗi, tùy chọn): lọc theo phần tài liệu.
• source (docs, site, hoặc all, tùy chọn): mặc định là kho tài liệu.
• limit (số, tùy chọn): số lượng kết quả tối đa trả về.
• includeSnippets (boolean, tùy chọn): bao gồm đoạn trích khớp trong kết quả.

Ví dụ:

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

Đọc một trang hoặc phần tài liệu dưới dạng Markdown theo tiêu đề, URL, đường dẫn hoặc id danh mục.

Tham số

• target (chuỗi, bắt buộc): tiêu đề tài liệu, URL, đường dẫn hoặc id danh mục.
• source (docs, site, hoặc all, tùy chọn): mặc định là kho tài liệu.
• maxChars (số, tùy chọn): số ký tự Markdown tối đa trả về.
• preferCachedContent (boolean, tùy chọn): sử dụng kho tài liệu được lập chỉ mục khi có sẵn.

Ví dụ:

Read the Octagon MCP server guide.

octagon-docs-refresh

Làm mới danh mục tài liệu trong bộ nhớ từ các điểm cuối tài liệu thân thiện với LLM trực tiếp.

Tham số

• includeSite (boolean, tùy chọn): cũng làm mới chỉ mục trang https://octagonai.co/llms.txt rộng hơn.

Tài nguyên Tài liệu

Các ứng dụng khách hỗ trợ tài nguyên MCP cũng có thể duyệt:

• octagon-docs://catalog: danh mục tài liệu trực tiếp được chuẩn hóa.
• octagon-docs://status: trạng thái bộ nhớ đệm, điểm cuối nguồn và siêu dữ liệu làm mới.
• octagon-docs://page/{target}: một trang hoặc phần tài liệu dưới dạng Markdown.

octagon-agent

Điều phối phân tích thông tin thị trường công khai và riêng tư.

Tham số

• prompt (chuỗi, bắt buộc): yêu cầu nghiên cứu bằng ngôn ngữ tự nhiên.
• conversation (chuỗi, tùy chọn): ID hội thoại Octagon hiện có để tiếp tục luồng octagon-agent trước đó. Bỏ qua tham số này ở lượt đầu tiên.
• newConversation (boolean, tùy chọn): nếu true, bắt đầu một luồng Octagon mới cho neo phiên/luồng đang hoạt động. Khuyến nghị cho lượt đầu tiên của một cuộc trò chuyện hiển thị mới trong các máy chủ lớp trên như Claude Desktop.

Sử dụng theo luồng

octagon-agent là công cụ MCP duy nhất chuyển tiếp luồng hội thoại Octagon. Đây là công cụ có trạng thái và mong đợi tính liên tục của phiên. MCP giải quyết trạng thái phiên/luồng theo thứ tự này:

1. hội thoại được lưu trữ cho danh tính phiên vận chuyển MCP, khi vận chuyển thực sự cung cấp nó
2. hội thoại được lưu trữ cho phiên stdio mặc định do máy chủ quản lý
3. conversation rõ ràng vẫn có thể ghi đè hội thoại phiên đang hoạt động cho lệnh gọi đó

Gói này hiện chạy dưới dạng máy chủ MCP stdio. Ở chế độ stdio, máy chủ tự động thiết lập một phiên cục bộ tiến trình để liên tục qua các lệnh gọi. Hầu hết các máy chủ cục bộ như Claude Desktop hoặc Cursor do đó có thể sử dụng octagon-agent mà không cần cung cấp thêm bất kỳ trường luồng nào cho hành vi theo dõi cơ bản.

Khi một máy chủ lớp trên biết một lệnh gọi là lượt đầu tiên của một cuộc trò chuyện hiển thị mới, nó nên truyền newConversation: true. Điều đó rõ ràng xóa bất kỳ luồng Octagon nào được lưu trữ cho neo phiên MCP đang hoạt động trước lệnh gọi, ngăn chặn tính liên tục cũ khi một máy chủ stdio tái sử dụng cùng một tiến trình MCP tồn tại lâu dài qua nhiều cuộc trò chuyện hiển thị.

Điều này có nghĩa là bạn có thể sử dụng bất kỳ mẫu nào sau đây:

1. Lệnh gọi đầu tiên: chỉ gửi prompt
2. Để máy chủ MCP duy trì tính liên tục phiên vận chuyển hoặc dựa vào phiên stdio mặc định
3. Lệnh gọi thứ hai: hoặc
   • gửi prompt mới trong cùng phiên MCP, hoặc
   • tiếp tục sử dụng cùng tiến trình MCP stdio, hoặc
   • truyền rõ ràng conversation trước đó

Danh tính phiên vận chuyển là nguyên thủy liên tục chính tắc cho các vận chuyển MCP có trạng thái tuân thủ tiêu chuẩn. Đối với việc sử dụng stdio cục bộ, phiên tiến trình do máy chủ quản lý cung cấp tính liên tục mặc định.

Danh tính phiên và danh tính hội thoại Octagon là các khái niệm khác nhau:

• Danh tính phiên MCP kiểm soát tính liên tục phía máy chủ qua các lệnh gọi công cụ
• conversation Octagon kiểm soát luồng Octagon đang hoạt động bên trong phiên đó

Kết quả MCP giữ câu trả lời trong content, và cũng trả về siêu dữ liệu có cấu trúc cho các bộ điều phối trong 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."
  }
}

Ví dụ chuyển tiếp rõ ràng:

{
  "prompt": "AAPL",
  "conversation": "conv_123"
}

Ví dụ cuộc trò chuyện hiển thị mới:

{
  "prompt": "Analyze Apple",
  "newConversation": true
}

Ví dụ làm mới rõ ràng:

{
  "prompt": "Start a fresh Octagon thread for this chat",
  "newConversation": true
}

Chính sách công cụ có trạng thái

• octagon-agent: có trạng thái, sử dụng neo liên tục khả dụng. Trong các máy chủ stdio, mặc định là phiên tiến trình do máy chủ quản lý trừ khi bạn cung cấp conversation rõ ràng
• các công cụ MCP khác: không trạng thái và có thể chạy mà không cần tính liên tục phiên

Ví dụ:

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

Thêm ví dụ:

• "Doanh thu và thu nhập ròng của Amazon trong Q4 2023 là bao nhiêu?"
• "Phân tích xu hướng chi tiêu R&D của Tesla trong 3 năm qua."
• "CEO của NVIDIA đã đưa ra hướng dẫn gì về nhu cầu chip AI trong cuộc gọi thu nhập mới nhất của họ?"
• "So sánh tỷ lệ giá trên thu nhập, giá trên doanh thu và EV/EBITDA cho 5 công ty bán dẫn hàng đầu."
• "Quy mô vòng gọi vốn mới nhất, định giá và các nhà đầu tư chính của Anthropic là gì?"
• "Andreessen Horowitz đã thực hiện bao nhiêu khoản đầu tư vào các startup AI trong 12 tháng qua?"
• "Các bài báo tin tức mới nhất về cổ phiếu NVIDIA từ tuần qua là gì?"

octagon-deep-research-agent

Thực hiện nghiên cứu sâu và tổng hợp đa nguồn toàn diện.

Tham số

• prompt (chuỗi, bắt buộc): yêu cầu nghiên cứu bằng ngôn ngữ tự nhiên.

Ví dụ:

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

Thêm ví dụ:

• "Trích xuất tất cả các trường dữ liệu từ zillow.com/san-francisco-ca/"
• "Nghiên cứu tác động tài chính của các thay đổi quyền riêng tư của Apple đối với doanh thu và biên lợi nhuận của các công ty quảng cáo kỹ thuật số"
• "Truy xuất dữ liệu giá Bitcoin lịch sử từ năm 2023 và phân tích xu hướng biến động giá"
• "Phân tích động lực cạnh tranh trong thị trường cơ sở hạ tầng sạc EV"

octagon-prediction-markets-agent

Tạo báo cáo nghiên cứu cho các sự kiện thị trường dự đoán Kalshi.

Tham số

• prompt (chuỗi, bắt buộc): yêu cầu nghiên cứu bằng ngôn ngữ tự nhiên.
• cache (boolean, tùy chọn): kiểm soát định tuyến biến thể tác nhân.
  • bỏ qua: prediction-markets-agent
  • false: prediction-markets-agent:refresh
  • true: prediction-markets-agent:cache

Ví dụ:

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

prediction_markets_history

Lấy dữ liệu lịch sử cho một mã sự kiện thị trường dự đoán với phân trang và bộ lọc thời gian tùy chọn.

Tham số

• event_ticker (chuỗi, bắt buộc)
• limit (số, tùy chọn)
• cursor (chuỗi, tùy chọn)
• captured_from (chuỗi, tùy chọn)
• captured_to (chuỗi, tùy chọn)
• include_analysis (boolean, tùy chọn; khi true, yêu cầu cột phân tích)

Ví dụ:

Fetch historical data for the Kalshi event https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

Khắc phục sự cố

1. Vấn đề về Khóa API: Đảm bảo khóa API Octagon của bạn được thiết lập chính xác trong môi trường hoặc tệp cấu hình.
2. Vấn đề về Kết nối: Đảm bảo kết nối đến API Octagon hoạt động bình thường.
3. Giới hạn Tốc độ: Nếu bạn gặp lỗi giới hạn tốc độ, hãy giảm tần suất yêu cầu của bạn.

Giấy phép

MIT

Máy chủ MCP Chuyên biệt Riêng lẻ

Mặc dù máy chủ này cung cấp thông tin thị trường toàn diện bằng cách kết hợp tất cả các tác nhân chuyên biệt của chúng tôi, bạn cũng có thể sử dụng các máy chủ MCP riêng lẻ của chúng tôi cho các trường hợp sử dụng cụ thể:

Công cụ Nghiên cứu

• Octagon Deep Research MCP - Khả năng nghiên cứu toàn diện và thu thập dữ liệu web

---

⭐ Hãy gắn sao cho repo này nếu bạn thấy nó hữu ích!