Twelve Data MCP Server

공식

Twelve Data API와 상호작용하여 AI 에이전트를 위한 실시간 및 과거 금융 시장 데이터에 접근할 수 있습니다.

GitHub
70

문서

Twelve Data MCP 서버

Claude, ChatGPT 및 기타 AI 어시스턴트를 Twelve Data 금융 API에 연결하세요 — 실시간 및 과거 가격, 60개 이상의 기술 지표, 펀더멘털, 실적, 배당금, ETF, 기업 뉴스, 시장 주도주 등 다양한 정보를 제공합니다.

Twelve Data 계정이 필요합니다. twelvedata.com에서 가입하세요.

사용 방법은 두 가지입니다. 대부분의 사용자는 클라우드 서버(옵션 1)를 사용하는 것이 좋습니다 — 설치할 필요가 없습니다.

옵션 1 — 클라우드 서버 사용 (권장)

AI 어시스턴트를 호스팅된 서버에 연결하세요:

https://mcp.twelvedata.com/mcp

이것으로 끝입니다. 설치도, 복사하여 붙여넣을 API 키도 필요 없습니다. 연결하면 브라우저 창이 열리고 Twelve Data 계정으로 로그인하면 개인 API 키가 자동으로 연결되어 계정에 유지됩니다.

추가 방법

Claude (데스크톱 / 웹) 및 ChatGPT는 사용자 정의 커넥터 / MCP 서버를 지원합니다:

  1. 어시스턴트의 커넥터 (또는 통합 / MCP 서버) 설정을 엽니다.
  2. URL https://mcp.twelvedata.com/mcp로 새 커넥터를 추가합니다.
  3. 메시지가 표시되면 연결 / 로그인을 클릭하면 브라우저에 Twelve Data 로그인 페이지가 열립니다.
  4. 승인하면 완료됩니다. "AAPL의 RSI는 얼마인가요?" 또는 "TSLA의 최신 실적을 보여주세요." 와 같이 질문할 수 있습니다.

정확한 메뉴 이름은 앱과 버전에 따라 다르지만, 흐름은 항상 동일합니다: URL을 추가한 다음 브라우저 팝업을 통해 로그인합니다.

옵션 2 — API 키로 로컬에서 실행

자신의 컴퓨터에서 서버를 실행하는 것을 선호하시나요 (예: stdio를 통한 Claude 데스크톱)? Twelve Data API 키만 있으면 됩니다 — OAuth 설정이 필요 없습니다.

1. API 키 받기

twelvedata.com에 로그인 → 대시보드 → API 키에서 키를 복사합니다.

2. 설치

Python 3.10 이상이 필요합니다 (3.12 권장; macOS의 경우 brew install [email protected] 또는 make python-install).

make install

3. API 키 추가

프로젝트 루트에 .env 파일을 만들고 키를 입력합니다:

TWELVE_DATA_API_KEY=your_api_key_here

4. Claude 데스크톱에 연결

~/Library/Application Support/Claude/claude_desktop_config.json에 추가합니다:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/twelve-data-mcp/.venv/bin/python",
      "args": ["/path/to/twelve-data-mcp/src/server.py"]
    }
  }
}

.venv/bin/python 경로를 사용하세요 (시스템 Python이 아닙니다 — macOS는 3.9를 제공하며, 이 서버는 3.10 이상이 필요합니다). 설정을 편집한 후 Claude 데스크톱을 다시 시작하세요.

이것으로 완료입니다 — 서버가 .env에서 API 키를 읽어 모든 요청에 사용합니다. 로그인 단계가 필요 없습니다.

질문할 수 있는 내용

  • 가격 — 주식, ETF, 외환, 암호화폐, 원자재 (실시간 및 과거 데이터)
  • 기술 지표 — RSI, MACD, SMA, BBANDS, ATR 외 60개 이상
  • 펀더멘털 — 재무제표, 실적, 배당금, 주식 분할, 기업 프로필, 시가총액, 주요 통계, IPO 캘린더
  • 펀드 — ETF 및 뮤추얼 펀드 프로필, 성과, 보유 종목, 위험
  • 뉴스 — 기업 뉴스 및 보도 자료
  • 시장 인텔리전스 — 주도주, 환율, 애널리스트 평가, 목표 주가
  • 규제 — SEC/EDGAR 제출 서류, 내부자 거래, 기관 보유 현황

심볼 형식: 주식 AAPL, 암호화폐 BTC/USD, 외환 EUR/USD.

파트너

공개 인스턴스를 직접 운영하거나 전용 OAuth 로그인을 설정하시나요? 이는 파트너 계약에 해당합니다 — twelvedata.com으로 문의해 주시면 설정 가이드와 OAuth 자격 증명을 제공해 드리겠습니다.