TickerDB MCP 서버

TickerDB용 MCP(Model Context Protocol) 서버 — AI 에이전트를 위한 사전 계산된 시장 인텔리전스입니다.

TickerDB를 Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, LangChain, LlamaIndex, AutoGen, CrewAI 등 모든 MCP 호환 클라이언트에 연결하세요.

사용 가능한 도구

날짜 범위에 걸친 대량 티커 동기화를 위해 start/end 매개변수와 함께 get_summary를 사용하거나, 이벤트 발생을 쿼리하기 위해 field/band 매개변수를 사용하세요.

밴드 안정성 메타데이터

요약, 관심 종목 및 관심 종목 변경 도구는 밴드 안정성 메타데이터를 반환합니다. 각 밴드 필드(추세 방향, 모멘텀 영역 등)에는 해당 상태가 얼마나 안정적인지 설명하는 형제 _meta 객체가 포함되어 있습니다. 안정성 레이블은 fresh, holding, established 또는 volatile 중 하나입니다. 전체 메타데이터에는 periods_in_current_state, flips_recent 및 flips_lookback도 포함됩니다. 이 컨텍스트는 에이전트가 새로 진입한 상태와 여러 기간 동안 지속된 상태를 구별하도록 도와주어 거래 신호 및 알림의 품질을 향상시킵니다.

설정

옵션 1: Claude.ai (OAuth)

mcp.tickerdb.com의 원격 서버는 Claude.ai 커넥터를 위한 OAuth 2.1을 지원합니다. API 키 관리가 필요 없으며, TickerDB 계정으로 로그인하면 Claude.ai가 나머지를 처리합니다.

옵션 2: 원격 서버 (Bearer 토큰)

API 키를 Bearer 토큰으로 사용하여 모든 MCP 클라이언트를 https://mcp.tickerdb.com/mcp에 연결하세요.

옵션 3: npm 패키지 (Claude Desktop, Cursor 등)

Claude Desktop 설정(claude_desktop_config.json)에 추가하세요:

{
  "mcpServers": {
    "tickerdb": {
      "command": "npx",
      "args": ["tickerdb-mcp-server"],
      "env": {
        "TICKERDB_KEY": "tapi_your_api_key_here"
      }
    }
  }
}

tickerdb.com/dashboard에서 API 키를 받으세요.

구조

이것은 3개의 패키지로 구성된 워크스페이스입니다:

• shared/ — 공유 도구 정의, API 클라이언트 및 서버 팩토리 (내부용, 게시되지 않음)

• remote/ — mcp.tickerdb.com에 배포된 Cloudflare Worker (스트리밍 가능한 HTTP 전송 + OAuth 2.1)

• local/ — 게시된 npm 패키지 tickerdb-mcp-server (stdio 전송)

원격 서버와 npm 패키지 모두 shared/의 동일한 도구 정의를 사용합니다. MCP 서버는 씬 프록시(thin proxy)이며, 모든 등급 기반 액세스 제어, 속도 제한 및 필드 필터링은 TickerDB HTTP API에 의해 처리됩니다.

인증

원격 서버는 두 가지 인증 방법을 지원합니다:

• Bearer 토큰 — tapi_* API 키를 Authorization: Bearer tapi_...로 직접 전달

• OAuth 2.1 — Claude.ai 커넥터에서 사용. 서버는 동적 클라이언트 등록, PKCE, 토큰 교환 및 취소를 구현합니다. /authorize 엔드포인트는 동의를 위해 메인 TickerDB 사이트로 리디렉션합니다.

개발

# Install dependencies
npm install

# Build the remote worker
npm run build

# Dev server for remote worker
npx wrangler dev

# Build the npm package
cd local && npm install && npm run build

배포

원격 서버:

npx wrangler deploy

npm 패키지:

cd local
npm version patch
npm run build
npm publish