MCP-FREDAPI

Integración de la API de FRED (Datos Económicos de la Reserva Federal) con el Protocolo de Contexto de Modelo (MCP)

Tabla de contenido

• Introducción

• Instalación

• Configuración

  • Clave API de FRED

  • Configuración de Claude/Cursor

• Herramientas disponibles

• Parámetros

• Ejemplos

  • Identificadores de series económicas comunes

• Contribuyendo

• Licencia

• Referencias

Related MCP server: FRED MCP Server

Introducción

MCP-FREDAPI proporciona acceso a datos económicos del Banco de la Reserva Federal de San Luis (FRED) mediante el Protocolo de Contexto de Modelo. Esta integración permite a asistentes de IA como Claude recuperar datos de series temporales económicas directamente al usar Cursor u otros entornos compatibles con MCP.

Este paquete se integra con la API oficial de FRED , centrándose específicamente en el punto final series_observations que proporciona datos de series de tiempo para indicadores económicos.

Instalación

Hay dos métodos de instalación:

Método 1: Usar pip

Instale las dependencias necesarias:

pip install "mcp[cli]" httpx python-dotenv

Clonar este repositorio:

git clone https://github.com/Jaldekoa/mcp-fredapi.git
cd mcp-fredapi

Método 2: Uso de luz ultravioleta (recomendado)

Se recomienda este método ya que coincide con la configuración que se muestra en mcp.json.

1. Primero, instala uv si aún no lo tienes:

pip install uv

2. Clonar este repositorio:

git clone https://github.com/Jaldekoa/mcp-fredapi.git
cd mcp-fredapi

3. Utilice uv para ejecutar el servidor (no es necesario instalar dependencias por separado):

uv run --with mcp --with httpx mcp run server.py

Configuración

Clave API de FRED

Necesitará una clave API de FRED, que puede obtener en FRED API .

Cree un archivo .env en la raíz del proyecto:

FRED_API_KEY=your_api_key_here

Configuración de Claude/Cursor

Para configurar Cursor para que use este servidor MCP, agregue lo siguiente a su archivo ~/.cursor/mcp.json :

{
  "mcpServers": {
    "mcp-fredapi": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-fredapi", "run", "--with", "mcp", "--with", "httpx", "mcp", "run", "server.py"]
    }
  }
}

Reemplace /path/to/mcp-fredapi con la ruta real del repositorio en su sistema. Por ejemplo:

{
  "mcpServers": {
    "mcp-fredapi": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-fredapi", "run", "--with", "mcp", "--with", "httpx", "mcp", "run", "server.py"]
    }
  }
}

Nota: En Windows, puede utilizar barras diagonales / o barras diagonales invertidas dobles \\ en la ruta.

Herramientas disponibles

obtener_observaciones_de_la_serie_fred

Recupera observaciones de series de tiempo económicas de FRED.

Al usar Claude en Cursor, puedes acceder a esta herramienta directamente con:

@mcp-fredapi:get_fred_series_observations

Parámetros

La herramienta get_fred_series_observations acepta los siguientes parámetros. Para obtener información técnica completa sobre cada parámetro, consulte la documentación oficial de la API de FRED .

[!ADVERTENCIA] Nota sobre la compatibilidad de parámetros

Debido a las limitaciones actuales con la implementación de MCP, solo ciertos parámetros funcionan correctamente:

• ✅ Parámetros de trabajo : series_id , sort_order , units , frequency , gregation_method , and output_type.

• ❌ Parámetros que no funcionan : realtime_start , realtime_end , limit , offset , observation_start , observation_end y vintage_dates .

Para obtener los mejores resultados, mantenga los parámetros de trabajo en sus consultas. Las futuras actualizaciones podrían solucionar estas limitaciones.

Ejemplos

Obtención de datos del PIB de EE. UU.

Al usar Claude en Cursor, puedes solicitar datos del PIB de la siguiente manera:

Can you get the latest GDP data from FRED?

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP"
}

Obtener datos del PIB en orden descendente

Can you get the GDP data in descending order (newest first)?

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP",
  "sort_order": "desc"
}

Obtención de datos del PIB anual

Can you get annual GDP data?

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP",
  "frequency": "a"
}

Obtener la tasa de inflación

Para obtener datos del índice de precios al consumidor con cambio porcentual:

What's the recent inflation rate in the US?

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "CPIAUCSL",
  "units": "pch",
  "frequency": "m"
}

Formato de salida diferente

Show me GDP data in a different format.

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP",
  "output_type": 2
}

Contribuyendo

Se agradecen las contribuciones. Por favor, siga estos pasos:

1. Bifurcar el repositorio

2. Crear una rama de características ( git checkout -b feature/amazing-feature )

3. Realiza tus cambios

4. Confirme sus cambios ( git commit -m 'Add an amazing feature' )

5. Empujar a la rama ( git push origin feature/amazing-feature )

6. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Referencias

• Documentación de la API de FRED - Observaciones de la serie : documentación oficial del punto final de la API de FRED utilizado en este proyecto.

• API de FRED : información sobre cómo obtener una clave API y documentación general de API.

• Protocolo de Contexto Modelo - Documentación para el Protocolo de Contexto Modelo.