Fedspeak MCP Server

Accede y analiza declaraciones de la Reserva Federal (FOMC).

Documentación

Servidor MCP de Fedspeak

Un servidor de Model Context Protocol (MCP) para acceder y analizar declaraciones de la Reserva Federal (FOMC).

Descripción general

Este servidor proporciona una interfaz de Model Context Protocol (MCP) para acceder y analizar declaraciones de la Reserva Federal (FOMC). Permite la búsqueda semántica y el análisis de declaraciones del FOMC, manejando toda la complejidad de la recuperación y el procesamiento de datos detrás de una interfaz limpia basada en herramientas.

Características

Buscar declaraciones: Busca semánticamente declaraciones del FOMC por tema, fecha o contenido
Acceso a metadatos: Obtén información sobre las declaraciones disponibles
Análisis de tendencias: Analiza las tendencias del lenguaje en las declaraciones de la Fed a lo largo del tiempo
Acceso a recursos: Accede al contenido completo de las declaraciones como recursos
Plantillas de prompts: Usa plantillas de prompts predefinidas para tareas de análisis comunes

Instalación

Requisitos previos

Python 3.10 o superior
Un servidor API privado en ejecución con acceso a la base de datos del FOMC

Instalar desde el código fuente

# Clone the repository
git clone https://github.com/yourusername/fomc-mcp-server.git
cd fomc-mcp-server

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package
# Install with pip
pip install .

# Install with UV (recommended for exact dependency versions)
uv pip install .

Configuración

El servidor se puede configurar usando variables de entorno:

FEDSPEAK_API_ENDPOINT: URL del servicio API backend para operaciones de datos (predeterminado: "https://fedspeak-mcp-backend-671377599496.us-central1.run.app")
LOG_LEVEL: Nivel de registro (predeterminado: "INFO")
LOG_FILE: Ruta del archivo de registro (predeterminado: "fedspeak_mcp_server.log")

Nota: No se necesita configuración adicional para el acceso a datos; todas las conexiones requeridas se manejan automáticamente.

Uso

Ejecutar el servidor

# Run directly
python -m fedspeak

# Or using the installed script
fedspeak

Uso con Claude para Desktop

Para usar con Claude para Desktop, agrega este servidor a tu archivo de configuración de Claude:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fedspeak": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/mk/Documents/Python/AI Playground/mcp/fedspeak/src/fedspeak",
        "run",
        "fedspeak"
      ],
      "env": {
        "FEDSPEAK_API_ENDPOINT": "https://fedspeak-mcp-backend-671377599496.us-central1.run.app"
      }
    }
  }
}

Nota: Esta configuración usa UV para ejecutar el servidor fedspeak en una estructura de paquete basada en src. El endpoint de la API se conecta al servicio backend de Cloud Run que maneja todas las operaciones de base de datos y la recuperación de declaraciones del FOMC.

Herramientas disponibles

search_fomc_statements: Busca declaraciones de la Reserva Federal semánticamente
get_fomc_metadata: Obtén metadatos sobre las declaraciones del FOMC disponibles
analyze_fomc_trends: Analiza tendencias en el lenguaje de la Reserva Federal a lo largo del tiempo
get_latest_statement: Obtén la declaración más reciente del FOMC con texto completo

Prompts disponibles

search-guidance: Cómo buscar declaraciones del FOMC de manera efectiva
analyze-trends-guidance: Cómo analizar tendencias en el lenguaje del FOMC a lo largo del tiempo
latest-statement-analysis: Cómo analizar la declaración más reciente del FOMC

Licencia

MIT