서론

이는 금융 데이터셋에서 주식 시장 데이터에 접근할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

이 시스템은 클로드와 다른 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 패키지 관리자

설치

Financial Datasets MCP Server

Introduction

This is a Model Context Protocol (MCP) server that provides access to stock market data from Financial Datasets.

It allows Claude and other AI assistants to retrieve income statements, balance sheets, cash flow statements, stock prices, and market news directly through the MCP interface.

Available Tools

This MCP server provides the following tools:

• get_income_statements: Get income statements for a company.
• get_balance_sheets: Get balance sheets for a company.
• get_cash_flow_statements: Get cash flow statements for a company.
• get_current_stock_price: Get the current / latest price of a company.
• get_historical_stock_prices: Gets historical stock prices for a company.
• get_company_news: Get news for a company.
• get_available_crypto_tickers: Gets all available crypto tickers.
• get_crypto_prices: Gets historical prices for a crypto currency.
• get_historical_crypto_prices: Gets historical prices for a crypto currency.
• get_current_crypto_price: Get the current / latest price of a crypto currency.

Setup

Prerequisites

• Python 3.10 or higher
• uv package manager

Installation

1. Clone this repository:

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

2. If you don’t have uv installed, install it:

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

3. Install dependencies:

   # 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. Set up environment variables:

   # 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. Run the server:

   uv run server.py
   

Connecting to Claude Desktop

1. Install Claude Desktop if you haven’t already

2. Create or edit the Claude Desktop configuration file:

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

3. Add the following configuration:

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

   Replace /path/to/uv with the result of which uv and /absolute/path/to/financial-datasets-mcp with the absolute path to this project.

4. Restart Claude Desktop