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