Skip to main content
Glama
Sign In
enesjakozh

MCP-FREDAPI

by Jaldekoa
GitHub
Python
MIT License
2
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

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
  1. Clonar este repositorio:
git clone https://github.com/Jaldekoa/mcp-fredapi.git cd mcp-fredapi
  1. 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ámetroTipoDescripciónValores permitidosValor predeterminadoEstado
id de seriecadenaEl ID de la serie económica-(Requerido)✅ Obras
orden de clasificacióncadenaOrden de clasificación de las observaciones'ascendente', 'descendente''asc'✅ Obras
unidadescadenaTransformación del valor de los datos'lin', 'chg', 'ch1', 'pch', 'pc1', 'pca', 'cch', 'cca', 'log''lin'✅ Obras
frecuenciacadenaFrecuencia de observaciones'd', 'w', 'bw', 'm', 'q', 'sa', 'a', 'wef', 'weth', 'wew', 'wetu', 'wem', 'wesu', 'wesa', 'bwew', 'bwem'Ninguno✅ Obras
método de agregacióncadenaMétodo de agregación para frecuencia'promedio', 'suma', 'fin de operación''promedio'✅ Obras
tipo_de_salidaenteroTipo de salida de las observaciones1, 2, 3, 41✅ Obras
inicio en tiempo realcadenaInicio del período de tiempo real (AAAA-MM-DD)-Ninguno❌ No funciona
fin en tiempo realcadenaFin del período de tiempo real (AAAA-MM-DD)-Ninguno❌ No funciona
límiteentero/cadenaNúmero máximo de observaciones a devolverEntre 1 y 10000010❌ No funciona
compensarentero/cadenaNúmero de observaciones a omitir desde el principio-0❌ No funciona
inicio de observacióncadenaFecha de inicio de las observaciones (AAAA-MM-DD)-Ninguno❌ No funciona
fin de la observacióncadenaFecha de finalización de las observaciones (AAAA-MM-DD)-Ninguno❌ No funciona
fechas de cosechacadenaLista 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:

  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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Proporciona acceso a datos económicos del Banco de la Reserva Federal de St. Louis (FRED) a través del Protocolo de Contexto de Modelo, lo que permite a los asistentes de IA recuperar datos de series de tiempo económicas directamente.

  1. Tabla de contenido
    1. Introducción
      1. Instalación
        1. Método 1: Usar pip
        2. Método 2: Uso de luz ultravioleta (recomendado)
      2. Configuración
        1. Clave API de FRED
        2. Configuración de Claude/Cursor
      3. Herramientas disponibles
        1. obtener\_observaciones\_de\_la\_serie\_fred
      4. Parámetros
        1. Ejemplos
          1. Obtención de datos del PIB de EE. UU.
          2. Obtener datos del PIB en orden descendente
          3. Obtención de datos del PIB anual
          4. Obtener la tasa de inflación
          5. Formato de salida diferente
        2. Contribuyendo
          1. Licencia
            1. Referencias

              Related Resources

              Related MCP Servers

              • FRED MCP Server

                kablewy
                A
                security
                F
                license
                A
                quality
                A Model Context Protocol server that provides tools to search and retrieve economic data series from the Federal Reserve Economic Data (FRED) API.
                Last updated -
                2
                3
                TypeScript

              • Financial Datasets MCP Serverofficial

                financial-datasets
                -
                security
                A
                license
                -
                quality
                MCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.
                Last updated -
                253
                Python
                MIT License
                • Apple

              • Beanquery MCP Server

                vanto
                -
                security
                A
                license
                -
                quality
                An experimental server implementing the Model Context Protocol to allow AI assistants to query and analyze financial data stored in Beancount ledger files using the Beancount Query Language.
                Last updated -
                2
                Python
                MIT License

              • Financial Modeling Prep MCP Server

                shadi-fsai
                -
                security
                A
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants like Claude to programmatically access financial data from Financial Modeling Prep API, including company profiles, financial statements, metrics, SEC filings, and market data.
                Last updated -
                5
                Python
                MIT License

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/Jaldekoa/mcp-fredapi'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server