Servidor MCP de datos macroeconómicos de FRED

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a los Datos Económicos de la Reserva Federal (FRED) a través de Claude y otros clientes LLM. Este servidor expone series de datos económicos de FRED, funciones de búsqueda y herramientas de recuperación de datos.

Características

• Acceso a indicadores económicos comunes de FRED (PIB, Empleo, Inflación, etc.)

• Funcionalidad de búsqueda para la serie de datos FRED

• Obtención de datos en tiempo real desde la API de FRED

• Formato de datos estandarizado para el consumo de LLM

• Creado con el SDK de Python de MCP para una integración perfecta

Prerrequisitos

• Python 3.11 o superior

• uv - Instalador de paquetes de Python moderno

• Claude Desktop para uso local

• Clave API de FRED (obtenga una de FRED API )

Instalación

1. Clonar el repositorio:

git clone https://github.com/yourusername/WM_mcp.git
cd WM_mcp

2. Crear y activar un entorno virtual usando uv:

uv venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

3. Instalar dependencias usando uv:

uv pip install "mcp[cli]>=1.6.0" "colorama>=0.4.6" "numpy>=2.2.4" "pandas>=2.2.3" "python-dotenv>=1.1.0" "requests>=2.32.3"

4. Configurar variables de entorno:

cp .env.example .env

Edite .env y agregue su clave API FRED:

FRED_API_KEY=your_fred_api_key_here

Instalación en Claude Desktop

1. Asegúrese de que Claude Desktop esté instalado y ejecutándose

2. Abra la configuración de Claude Desktop:

   • Vaya a Configuración > Desarrollador > Editar configuración

   • Agregue la siguiente configuración a su claude_desktop_config.json :

{
  "mcpServers": {
    "FRED Macroeconomic Data Server": {
      "command": "/path/to/your/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/your/WM_mcp",
        "run",
        "fred_macroeco_server.py"
      ]
    }
  }
}

Reemplaza /path/to/your/ con tus rutas actuales. Puedes encontrar la ruta de uv ejecutando which uv en la terminal.

Uso en Claude

1. Primero, busque en línea "usar recursos MCP en Claude Desktop Client" para comprender cómo incluir recursos MCP en sus conversaciones.

2. Una vez añadido el recurso, puede interactuar con los datos de FRED. Ejemplo de mensaje:

Use FRED APIs to get GDPs of USA last 20 years, draw chart

Recursos disponibles

• file://series/available - Lista todas las series FRED disponibles y sus detalles

Herramientas disponibles

• fetch_series_data : obtiene datos para cualquier serie FRED

• search_series - Busca la serie FRED por descripción

Desarrollo

Para desarrollo y pruebas:

1. Ejecute el Inspector MCP para probar el servidor:

mcp dev fred_macroeco_server.py

Esto le permite inspeccionar recursos, probar herramientas y verificar la funcionalidad del servidor.

2. Para ejecución directa del servidor (para comprobar si hay problemas):

python fred_macroeco_server.py

Nota: El servidor utiliza el transporte stdio para comunicarse con Claude Desktop. Utilice el Inspector MCP durante el desarrollo para detectar y solucionar cualquier problema antes de implementarlo en Claude Desktop.

Solución de problemas

1. Si recibes errores de clave API:

   • Verifique que su clave API FRED esté configurada correctamente en .env

   • Compruebe que el archivo .env esté en el directorio correcto

2. Si el servidor no aparece en Claude Desktop:

   • Verifique nuevamente las rutas de claude_desktop_config.json

   • Asegúrese de que uv y todas las dependencias estén instaladas correctamente

   • Intente reiniciar Claude Desktop

Expresiones de gratitud

• Banco de la Reserva Federal de St. Louis por proporcionar la API FRED

• Equipo de Protocolo de Contexto de Modelo para el SDK de MCP

• Anthropic para Claude y el cliente de escritorio de Claude