Fedspeak MCP Server

Acesse e analise declarações do Federal Reserve (FOMC).

Documentação

Fedspeak MCP Server

Um servidor Model Context Protocol (MCP) para acessar e analisar declarações do Federal Reserve (FOMC).

Visão Geral

Este servidor fornece uma interface Model Context Protocol (MCP) para acessar e analisar declarações do Federal Reserve (FOMC). Ele permite busca semântica e análise de declarações do FOMC, lidando com toda a complexidade de recuperação e processamento de dados por trás de uma interface limpa baseada em ferramentas.

Recursos

Buscar Declarações: Busque semanticamente declarações do FOMC por tópico, data ou conteúdo
Acesso a Metadados: Obtenha informações sobre as declarações disponíveis
Análise de Tendências: Analise tendências de linguagem nas declarações do Fed ao longo do tempo
Acesso a Recursos: Acesse o conteúdo completo das declarações como recursos
Modelos de Prompt: Use modelos de prompt pré-definidos para tarefas comuns de análise

Instalação

Pré-requisitos

Python 3.10 ou superior
Um servidor de API privado em execução com acesso ao banco de dados do FOMC

Instalar a partir do Código-Fonte

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

Configuração

O servidor pode ser configurado usando variáveis de ambiente:

FEDSPEAK_API_ENDPOINT: URL do serviço de API de backend para operações de dados (padrão: "https://fedspeak-mcp-backend-671377599496.us-central1.run.app")
LOG_LEVEL: Nível de registro (log) (padrão: "INFO")
LOG_FILE: Caminho do arquivo de log (padrão: "fedspeak_mcp_server.log")

Nota: Nenhuma configuração adicional é necessária para acesso aos dados - todas as conexões necessárias são tratadas automaticamente.

Uso

Executando o Servidor

# Run directly
python -m fedspeak

# Or using the installed script
fedspeak

Usando com Claude for Desktop

Para usar com o Claude for Desktop, adicione este servidor ao seu arquivo de configuração do 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 configuração usa UV para executar o servidor fedspeak em uma estrutura de pacote baseada em src. O endpoint da API se conecta ao serviço de backend do Cloud Run, que lida com todas as operações de banco de dados e recuperação de declarações do FOMC.

Ferramentas Disponíveis

search_fomc_statements: Busque declarações do Federal Reserve semanticamente
get_fomc_metadata: Obtenha metadados sobre as declarações do FOMC disponíveis
analyze_fomc_trends: Analise tendências na linguagem do Federal Reserve ao longo do tempo
get_latest_statement: Obtenha a declaração mais recente do FOMC com texto completo

Prompts Disponíveis

search-guidance: Como buscar declarações do FOMC de forma eficaz
analyze-trends-guidance: Como analisar tendências na linguagem do FOMC ao longo do tempo
latest-statement-analysis: Como analisar a declaração mais recente do FOMC

Licença

MIT