go -financeiro

Este MCP Server Financeiro é um servidor exemplo em Go que gerencia ferramentas financeiras simuladas e consulta cotações de ações reais via a API pública da Alpha Vantage. Ele expõe endpoints no estilo MCP para registrar ferramentas, listar ferramentas registradas, consultar preços de ações em tempo real e expor metadados do servidor no formato MCP. Você pode registrar uma ferramenta financeira, que descreve o serviço de cotação, listar todas as ferramentas registradas, e consultar o preço atual de uma ação passando o símbolo (por exemplo, AAPL). O endpoint de metadados (/metadata) segue o padrão MCP, permitindo que agentes clientes descubram informações sobre o servidor e suas ferramentas disponíveis.

Pré-requisitos:

• Go instalado na máquina (go version).
• Acesso à internet para consultar a Alpha Vantage.
• Uma chave de API gratuita da Alpha Vantage.

Passos:

1. Clonar o repositório (substitua pelo caminho do seu projeto):

git clone https://github.com/seuusuario/go-mcp-server-financeiro.git
cd go-mcp-server-financeiro

2. Criar o arquivo de configuração de ambiente com a API key:

# .env
ALPHA_VANTAGE_API_KEY=sua_api_key_aqui

3. Instalar dependências (caso haja módulos):

go mod tidy

4. Rodar o servidor:

go run cmd/main.go

O servidor ficará disponível em http://localhost:8080.

Observação: se preferir rodar com Docker, você pode adaptar um container Go com a imagem oficial e mapear as variáveis de ambiente acima.

Dicas úteis:

• Defina a variável ALPHA_VANTAGE_API_KEY com a chave válida da Alpha Vantage para que as consultas de cotação funcionem.
• Verifique o endpoint /metadata para confirmar o schema MCP exposto pelo servidor e as capacidades disponíveis.
• Ao registrar uma ferramenta financeira, forneça o nome, descrição, endpoint da API e o service_type conforme o que o aplicativo espera (por exemplo, cotacao).
• Se receber erros de CORS ou de rede ao consultar Alpha Vantage, verifique a conectividade da sua rede e o limite de chamadas da sua chave API.
• Use o comando GET /list-financial-tools para confirmar que as ferramentas foram registradas com sucesso.