Massive.com MCP 서버

LLM 친화적인 인터페이스를 통해 전체 Massive.com 금융 데이터 API에 대한 액세스를 제공하는 Model Context Protocol (MCP) 서버입니다.

이 서버는 엔드포인트당 하나의 도구를 노출하는 대신, 전체 Massive.com API 영역을 포괄하는 search(검색), call(호출), query(쿼리)라는 세 가지 구성 가능한 도구를 LLM에 제공합니다. 데이터는 인메모리 SQLite 데이터베이스에 저장될 수 있으며, 내장된 금융 함수를 사용하여 보강할 수 있습니다.

도구

내장 함수

함수는 call_api 및 query_data의 apply 매개변수를 통해 API 결과나 쿼리 출력에 적용할 수 있습니다. 함수를 찾으려면 scope="functions"와 함께 search_endpoints를 사용하세요.

데이터 범위

이 서버는 시작 시 llms.txt에서 모든 Massive.com API 엔드포인트를 동적으로 인덱싱하므로 API와 자동으로 동기화 상태를 유지합니다. 포함 범위는 다음과 같습니다:

• 주식, 옵션, 외환, 암호화폐 및 선물 집계

• 실시간 및 과거 거래 및 호가

• 시장 스냅샷, 상승/하락 종목

• 티커 세부 정보 및 참조 데이터

• 배당금, 주식 분할, IPO

• 재무 기본 데이터

• 애널리스트 등급 및 뉴스 (Benzinga)

• 국채 수익률, 인플레이션 데이터

• 시장 상태 및 휴일

Related MCP server: Dingo MCP Server

설치

사전 요구 사항

• Python 3.12+

• Massive.com API 키

• Astral UV (v0.4.0+)

Claude Code

먼저 Claude Code를 설치하세요.

npm install -g @anthropic-ai/claude-code

MCP 서버를 설치한 다음 Claude Code에 등록하세요:

# Install the server (one-time — downloads dependencies ahead of time)
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.9.1"

# Register with Claude Code
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massive

나중에 새 버전으로 업그레이드하려면:

uv tool upgrade mcp_massive

이 명령은 현재 프로젝트에 MCP 서버를 설치합니다. 전역으로 설치하려면 -s <scope> 플래그와 함께 명령을 실행할 수 있습니다. 더 많은 옵션은 claude mcp add --help를 참조하세요.

Claude Code를 시작하려면 터미널에서 claude를 실행하세요.

• 처음 사용하는 경우 설정 프롬프트에 따라 인증하세요.

Claude Desktop에 이미 MCP 서버가 설치되어 있다면 claude mcp add-from-claude-desktop을 실행할 수도 있습니다.

Claude Desktop

1. Claude Desktop MCP 설치 지침에 따라 초기 설치를 완료하고 구성 파일을 찾으세요.

2. 서버를 설치하세요:

uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.9.1"

3. 설치된 바이너리 경로를 찾으세요:

# Mac/Linux
which mcp_massive

# Windows
where mcp_massive

4. Claude Desktop 구성에 서버를 추가하세요. <path_to_mcp_massive>를 이전 단계의 출력으로 바꾸고 나머지 필드를 채우세요.

{
    "mcpServers": {
        "massive": {
            "command": "<path_to_mcp_massive>",
            "env": {
                "MASSIVE_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

구성

환경 변수

전송

기본적으로 STDIO 전송이 사용됩니다. 전송은 --transport CLI 인수 또는 MCP_TRANSPORT 환경 변수를 통해 설정할 수 있습니다(CLI 인수가 우선함).

# CLI argument
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http

# Environment variable
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive

사용 예시

통합이 완료되면 Claude에게 Massive.com 데이터에 액세스하도록 요청할 수 있습니다:

Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD
Calculate the 20-day SMA for AAPL closing prices over the last 3 months
Compute Black-Scholes delta for these option contracts

개발

로컬에서 실행

사전 요구 사항이 설치되어 있는지 확인하세요.

# Sync dependencies
uv sync

# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massive

로컬 체크아웃에서 설치한 다음 바이너리를 직접 참조하세요:

uv tool install --force /path/to/mcp_massive

{
  "mcpServers": {
    "massive": {
      "command": "mcp_massive",
      "env": {
        "MASSIVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

디버깅

디버깅 및 테스트를 위해 MCP Inspector 사용을 권장합니다:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massive

이 도구는 브라우저 인터페이스를 실행하여 MCP 서버와 직접 상호 작용하고 각 도구의 입력/출력을 확인할 수 있게 해줍니다.

브라우저 UI에서 STDIO 전송 유형을 선택하고 uv 및 run mcp_massive를 인수로 사용하세요.

코드 린팅

이 프로젝트는 일반적인 개발 작업을 위해 just를 사용합니다. PR을 제출하기 전에 코드를 린트하려면:

just lint

이 명령은 ruff format 및 ruff check --fix를 실행하여 코드를 자동으로 포맷하고 린팅 문제를 수정합니다.

링크

• Massive.com 문서

• Model Context Protocol

• MCP Python SDK

개인정보 처리방침

이 MCP 서버는 시장 데이터를 가져오기 위해 Massive.com의 API와 상호 작용합니다. 모든 데이터 요청은 Massive.com의 개인정보 처리방침 및 서비스 약관을 따릅니다.

• Massive.com 개인정보 처리방침: https://massive.com/legal/privacy

• 데이터 처리: 이 서버는 사용자 데이터를 저장하거나 캐시하지 않습니다. 모든 요청은 Massive.com의 API로 직접 프록시됩니다.

• API 키: Massive.com API 키는 API에 대한 요청을 인증하는 데만 사용됩니다.

• User-Agent: API 요청에는 MCP 서버 버전(예: MCP-Massive/0.x.y)이 포함된 User-Agent 문자열이 포함됩니다. 개인 식별 정보는 포함되지 않습니다.

기여

버그를 발견했거나 새로운 기능에 대한 아이디어가 있다면 먼저 새 이슈를 제출하여 논의해 주세요. 이슈에 대해서는 최대 3주 이내에 답변해 드립니다. 열려 있는 이슈에 대해 PR을 제출하고 싶으신 자원봉사자분들도 환영하지만, 사전에 저희와 논의해 주시기 바랍니다. 기존 이슈와 연결되지 않았거나 사전에 논의되지 않은 PR은 일반적으로 거절됩니다.