Financial Datasets

officiel

API boursière conçue pour les agents IA

GitHub
2.2k

Que pouvez-vous faire avec 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.

Documentation

Financial Datasets Serveur MCP

Introduction

Ceci est un serveur Model Context Protocol (MCP) qui donne accès aux données boursières de Financial Datasets.

Il permet à Claude et à d'autres assistants IA de récupérer des comptes de résultat, des bilans, des tableaux de flux de trésorerie, des cours boursiers et des actualités de marché directement via l'interface MCP.

Outils disponibles

Ce serveur MCP fournit les outils suivants :

  • get_income_statements : Obtenir les comptes de résultat d'une entreprise.
  • get_balance_sheets : Obtenir les bilans d'une entreprise.
  • get_cash_flow_statements : Obtenir les tableaux de flux de trésorerie d'une entreprise.
  • get_current_stock_price : Obtenir le prix actuel / le dernier prix d'une entreprise.
  • get_historical_stock_prices : Obtenir les prix historiques des actions d'une entreprise.
  • get_company_news : Obtenir les actualités d'une entreprise.
  • get_available_crypto_tickers : Obtenir tous les tickers crypto disponibles.
  • get_crypto_prices : Obtenir les prix historiques d'une crypto-monnaie.
  • get_historical_crypto_prices : Obtenir les prix historiques d'une crypto-monnaie.
  • get_current_crypto_price : Obtenir le prix actuel / le dernier prix d'une crypto-monnaie.

Configuration

Prérequis

  • Python 3.10 ou supérieur
  • Gestionnaire de paquets uv

Installation

  1. Cloner ce dépôt :

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

  2. Si vous n'avez pas uv installé, installez-le :

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

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

  3. Installer les dépendances :

    # 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. Configurer les variables d'environnement :

    # 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. Lancer le serveur :

    uv run server.py

Connexion à Claude Desktop

  1. Installer Claude Desktop si ce n'est pas déjà fait

  2. Créer ou modifier le fichier de configuration de Claude Desktop :

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

  3. Ajouter la configuration suivante :

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

    Remplacer /path/to/uv par le résultat de which uv et /absolute/path/to/financial-datasets-mcp par le chemin absolu vers ce projet.

  4. Redémarrer Claude Desktop

  5. Vous devriez maintenant voir les outils financiers disponibles dans le menu des outils de Claude Desktop (icône de marteau)

  6. Essayez de poser à Claude des questions comme :

    • "Quels sont les récents comptes de résultat d'Apple ?"
    • "Affiche-moi le prix actuel de l'action Tesla"
    • "Obtenir les prix historiques de MSFT du 01/01/2024 au 31/12/2024"