MCP Server Financeiro

Este projeto é um exemplo prático de como construir um MCP Server simples utilizando Go.

Ele simula a gestão de ferramentas financeiras e realiza consultas reais de cotações de ações utilizando a API pública da Alpha Vantage.

O objetivo é mostrar como estruturar um servidor que siga os princípios básicos do Model Context Protocol (MCP), incluindo a exposição de um endpoint /metadata.

Funcionalidades

• Registrar ferramentas financeiras dinamicamente
• Listar todas as ferramentas registradas
• Consultar preços de ações em tempo real (Alpha Vantage)
• Expor metadados no padrão MCP para agentes clientes

Estrutura de Endpoints

1. Registrar ferramenta financeira

POST http://localhost:8080/register-financial-tool
Content-Type: application/json

{
  "name": "Consulta Ações",
  "description": "Consulta cotações de ações em tempo real",
  "endpoint": "https://www.alphavantage.co/query",
  "service_type": "cotacao"
}

2. Listar ferramentas financeiras

GET http://localhost:8080/list-financial-tools
Accept: application/json

3. Consultar preço de uma ação (Alpha Vantage)

POST http://localhost:8080/query-stock-price
Content-Type: application/json

{
  "symbol": "AAPL"
}

4. Consultar metadados do MCP Server

GET http://localhost:8080/metadata
Accept: application/json

Pré-requisitos

• Conta gratuita na Alpha Vantage para gerar sua API Key

Como rodar o projeto

1. Clone o repositório

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

2. Crie um arquivo .env na raiz do projeto:

ALPHA_VANTAGE_API_KEY=sua_api_key_aqui

3. Instale as dependências

go mod tidy

4. Rode o servidor

go run cmd/main.go

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