Financial Datasets

공식

AI 에이전트를 위한 주식 시장 API

GitHub
2.2k

Financial Datasets MCP(으)로 무엇을 할 수 있나요?

  • Fetch income statements — Retrieve a company's income statements using get_income_statements.
  • Fetch balance sheets — Retrieve a company's balance sheets using get_balance_sheets.
  • Fetch cash flow statements — Retrieve a company's cash flow statements using get_cash_flow_statements.
  • Get current stock or crypto prices — Look up the latest price for a ticker via get_current_stock_price or get_current_crypto_price.
  • Get historical stock or crypto prices — Pull historical price data for a date range using get_historical_stock_prices or get_historical_crypto_prices.
  • Get company news — Retrieve recent news articles for a company with get_company_news.

문서

Financial Datasets MCP 서버

소개

이것은 Financial Datasets의 주식 시장 데이터에 대한 접근을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

이 서버를 통해 Claude 및 기타 AI 어시스턴트는 MCP 인터페이스를 통해 직접 손익계산서, 대차대조표, 현금흐름표, 주가 및 시장 뉴스를 조회할 수 있습니다.

사용 가능한 도구

이 MCP 서버는 다음 도구를 제공합니다:

  • get_income_statements: 기업의 손익계산서를 조회합니다.
  • get_balance_sheets: 기업의 대차대조표를 조회합니다.
  • get_cash_flow_statements: 기업의 현금흐름표를 조회합니다.
  • get_current_stock_price: 기업의 현재/최신 주가를 조회합니다.
  • get_historical_stock_prices: 기업의 과거 주가를 조회합니다.
  • get_company_news: 기업 관련 뉴스를 조회합니다.
  • get_available_crypto_tickers: 사용 가능한 모든 암호화폐 티커를 조회합니다.
  • get_crypto_prices: 암호화폐의 과거 가격을 조회합니다.
  • get_historical_crypto_prices: 암호화폐의 과거 가격을 조회합니다.
  • get_current_crypto_price: 암호화폐의 현재/최신 가격을 조회합니다.

설정

사전 요구 사항

  • Python 3.10 이상
  • uv 패키지 관리자

설치

  1. 이 저장소를 복제합니다:

    git clone https://github.com/financial-datasets/mcp-server
cd mcp-server

  2. uv가 설치되어 있지 않다면 설치합니다:

    # macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
curl -LsSf https://astral.sh/uv/install.ps1 | powershell

  3. 의존성을 설치합니다:

    # Create virtual env and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv add "mcp[cli]" httpx  # On Windows: uv add mcp[cli] httpx

  4. 환경 변수를 설정합니다:

    # Create .env file for your API keys
cp .env.example .env

# Set API key in .env
FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key

  5. 서버를 실행합니다:

    uv run server.py

Claude Desktop에 연결하기

  1. Claude Desktop이 설치되어 있지 않다면 먼저 설치합니다.

  2. Claude Desktop 구성 파일을 생성하거나 편집합니다:

    # macOS
mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

  3. 다음 구성을 추가합니다:

    {
  "mcpServers": {
    "financial-datasets": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/financial-datasets-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

    /path/to/uv을(를) which uv의 결과로, /absolute/path/to/financial-datasets-mcp을(를) 이 프로젝트의 절대 경로로 교체합니다.

  4. Claude Desktop을 다시 시작합니다.

  5. 이제 Claude Desktop의 도구 메뉴(망치 아이콘)에서 금융 도구를 사용할 수 있습니다.

  6. Claude에게 다음과 같은 질문을 해보세요:

    • "Apple의 최근 손익계산서를 보여줘"
    • "Tesla 주식의 현재 가격을 알려줘"
    • "2024-01-01부터 2024-12-31까지 MSFT의 과거 가격을 조회해줘"