Financial Datasets

oficial

API del mercado de valores diseñada para agentes de IA

GitHub
2.2k

¿Qué puedes hacer con 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.

Documentación

Financial Datasets MCP Server

Introducción

Este es un servidor de Model Context Protocol (MCP) que proporciona acceso a datos del mercado de valores desde Financial Datasets.

Permite a Claude y otros asistentes de IA recuperar estados de resultados, balances generales, estados de flujo de efectivo, precios de acciones y noticias del mercado directamente a través de la interfaz MCP.

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas:

  • get_income_statements: Obtiene los estados de resultados de una empresa.
  • get_balance_sheets: Obtiene los balances generales de una empresa.
  • get_cash_flow_statements: Obtiene los estados de flujo de efectivo de una empresa.
  • get_current_stock_price: Obtiene el precio actual / más reciente de una empresa.
  • get_historical_stock_prices: Obtiene precios históricos de acciones de una empresa.
  • get_company_news: Obtiene noticias de una empresa.
  • get_available_crypto_tickers: Obtiene todos los tickers de criptomonedas disponibles.
  • get_crypto_prices: Obtiene precios históricos de una criptomoneda.
  • get_historical_crypto_prices: Obtiene precios históricos de una criptomoneda.
  • get_current_crypto_price: Obtiene el precio actual / más reciente de una criptomoneda.

Configuración

Requisitos previos

  • Python 3.10 o superior
  • Gestor de paquetes uv

Instalación

  1. Clona este repositorio:

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

  2. Si no tienes uv instalado, instálalo:

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

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

  3. Instala las dependencias:

    # 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. Configura las variables de entorno:

    # 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. Ejecuta el servidor:

    uv run server.py

Conexión a Claude Desktop

  1. Instala Claude Desktop si aún no lo has hecho

  2. Crea o edita el archivo de configuración de Claude Desktop:

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

  3. Añade la siguiente configuración:

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

    Sustituye /path/to/uv por el resultado de which uv y /absolute/path/to/financial-datasets-mcp por la ruta absoluta a este proyecto.

  4. Reinicia Claude Desktop

  5. Ahora deberías ver las herramientas financieras disponibles en el menú de herramientas de Claude Desktop (icono de martillo)

  6. Prueba a hacerle preguntas a Claude como:

    • "¿Cuáles son los estados de resultados recientes de Apple?"
    • "Muéstrame el precio actual de las acciones de Tesla"
    • "Obtén precios históricos de MSFT desde 2024-01-01 hasta 2024-12-31"