Financial Datasets

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의 과거 가격을 조회해줘"