MCP-FREDAPI

Name: MCP-FREDAPI
Author: Jaldekoa

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

Related MCP server: Financial Modeling Prep 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.

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

pip install uv

Clonar este repositorio:

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

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 .

Parámetro	Tipo	Descripción	Valores permitidos	Valor predeterminado	Estado
id de serie	cadena	El ID de la serie económica	-	(Requerido)	✅ Obras
orden de clasificación	cadena	Orden de clasificación de las observaciones	'ascendente', 'descendente'	'asc'	✅ Obras
unidades	cadena	Transformación del valor de los datos	'lin', 'chg', 'ch1', 'pch', 'pc1', 'pca', 'cch', 'cca', 'log'	'lin'	✅ Obras
frecuencia	cadena	Frecuencia de observaciones	'd', 'w', 'bw', 'm', 'q', 'sa', 'a', 'wef', 'weth', 'wew', 'wetu', 'wem', 'wesu', 'wesa', 'bwew', 'bwem'	Ninguno	✅ Obras
método de agregación	cadena	Método de agregación para frecuencia	'promedio', 'suma', 'fin de operación'	'promedio'	✅ Obras
tipo_de_salida	entero	Tipo de salida de las observaciones	1, 2, 3, 4	1	✅ Obras
inicio en tiempo real	cadena	Inicio del período de tiempo real (AAAA-MM-DD)	-	Ninguno	❌ No funciona
fin en tiempo real	cadena	Fin del período de tiempo real (AAAA-MM-DD)	-	Ninguno	❌ No funciona
límite	entero/cadena	Número máximo de observaciones a devolver	Entre 1 y 100000	10	❌ No funciona
compensar	entero/cadena	Número de observaciones a omitir desde el principio	-	0	❌ No funciona
inicio de observación	cadena	Fecha de inicio de las observaciones (AAAA-MM-DD)	-	Ninguno	❌ No funciona
fin de la observación	cadena	Fecha de finalización de las observaciones (AAAA-MM-DD)	-	Ninguno	❌ No funciona
fechas de cosecha	cadena	Lista de fechas de cosecha separadas por comas	-	Ninguno	❌ No funciona

[!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:

Bifurcar el repositorio
Crear una rama de características ( git checkout -b feature/amazing-feature )
Realiza tus cambios
Confirme sus cambios ( git commit -m 'Add an amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
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.