Octagon MCP Server

공식

방대한 민간 및 공공 시장 데이터를 활용한 실시간 투자 리서치를 제공합니다.

GitHub
134

문서

Octagon: 공개 및 예측 시장 인텔리전스를 위한 MCP

smithery badge

Favicon Octagon MCP 서버는 Octagon Market Intelligence API와 통합하여 특화된 AI 기반 금융 조사 및 분석을 제공하며, Claude Desktop 및 기타 주요 MCP 클라이언트 내에서 공개 서류, 실적 발표, 재무 지표, 주식 및 암호화폐 데이터, 주식 뉴스, 예측 시장 뉴스 및 리서치를 분석하고 인사이트를 추출할 수 있도록 합니다.

Demo

도구

✅ 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 설치 프로그램 다운로드:
  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"
      }
    }
  }
}
  1. 변경 사항을 적용하려면 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"를 선택한 후 쿼리를 입력합니다.

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 클라이언트 설정 가이드는 다음을 참조하세요:

이 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

소스 URL 및 선택적 스니펫과 함께 Octagon API, 에이전트, MCP, 플러그인 문서를 검색합니다.

매개변수

  • query (문자열, 필수): 검색 쿼리.
  • section (문자열, 선택 사항): 문서 섹션별 필터링.
  • source (docs, site, 또는 all, 선택 사항): 기본값은 문서 코퍼스.
  • limit (숫자, 선택 사항): 반환할 최대 결과 수.
  • includeSnippets (불리언, 선택 사항): 결과에 일치하는 스니펫 포함.

예시:

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

제목, URL, 경로 또는 카탈로그 ID로 하나의 문서 페이지 또는 섹션을 Markdown으로 읽습니다.

매개변수

  • target (문자열, 필수): 문서 제목, URL, 경로 또는 카탈로그 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-agent 스레드를 이어가기 위한 기존 Octagon 대화 ID. 첫 번째 턴에서는 생략합니다.
  • newConversation (불리언, 선택 사항): true이면 활성 세션/스레드 앵커에 대해 새로운 Octagon 스레드를 시작합니다. Claude Desktop과 같은 최상위 호스트에서 완전히 새로운 가시적 채팅의 첫 번째 턴에 권장됩니다.

스레드 사용법

octagon-agent은 Octagon 대화 스레딩을 전달하는 유일한 MCP 도구입니다. 이는 상태 저장 도구이며 세션 연속성을 기대합니다. MCP는 다음 순서로 세션/스레드 상태를 해결합니다:

  1. 전송이 실제로 제공하는 경우 MCP 전송 세션 ID에 대한 저장된 대화
  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을 명시적으로 전달

전송 세션 ID는 표준 준수 상태 저장 MCP 전송을 위한 표준 연속성 기본 요소입니다. 로컬 stdio 사용의 경우 서버 관리 프로세스 세션이 기본 연속성을 제공합니다.

세션 ID와 Octagon 대화 ID는 다른 개념입니다:

  • MCP 세션 ID는 도구 호출 간 서버 측 연속성을 제어합니다
  • 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.

추가 예시:

  • "2023년 4분기 Amazon의 매출 및 순이익 수치는 얼마였나요?"
  • "지난 3년간 Tesla의 R&D 지출 추세를 분석해 주세요."
  • "최신 실적 발표에서 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년 비트코인 과거 가격 데이터를 검색하고 가격 변동성 추세를 분석해 주세요."
  • "EV 충전 인프라 시장의 경쟁 역학을 분석해 주세요."

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 서버를 사용할 수도 있습니다:

리서치 도구

⭐ 이 저장소가 도움이 되셨다면 별표를 눌러주세요!