About Go MCP Server Financeiro
Go MCP Server Financeiro is an MCP server published by tadrianonet in the AI category: exemplo prático de construção de um MCP Server em Go, com registro dinâmico de ferramentas financeiras, consultas reais à API Alpha Vantage e exposição de metadados para agentes clientes. Projeto focado em modularidade, extensibilidade e padronização seguindo o Model Context Protocol (MCP).
The repository has 3 stars and 1 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/tadrianonet/go-mcp-server-financeiroThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Go MCP Server Financeiro
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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
- Clone o repositório
git clone https://github.com/seuusuario/go-mcp-server-financeiro.git
cd go-mcp-server-financeiro
- Crie um arquivo
.envna raiz do projeto:
ALPHA_VANTAGE_API_KEY=sua_api_key_aqui
- Instale as dependências
go mod tidy
- Rode o servidor
go run cmd/main.go
O servidor ficará disponível em http://localhost:8080.
README fetched from the repository 5 days ago. The original is authoritative.