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

Clonar el repositorio:

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

Crear y activar un entorno virtual usando uv:

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

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"

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

Asegúrese de que Claude Desktop esté instalado y ejecutándose
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

Primero, busque en línea "usar recursos MCP en Claude Desktop Client" para comprender cómo incluir recursos MCP en sus conversaciones.
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:

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.

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

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
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