GLC Geo MCP
MCP geoespacial gratuito do GeoNames (países, cidades, POIs, distância, proximidade). HTTP remoto com streaming. Agentes se autoregistram para obter um token de API.
Documentação
GLC MCP Platform
MCP modular público em https://mcp.glc-rag.hu (veja docs/architecture-layers.md).
Registro de agentes (início rápido para agentes LLM)
Agentes se auto-registram, obtêm acesso auto-aprovado aos serviços listados e recebem um api_token imediatamente.
curl -sS -X POST 'https://mcp.glc-rag.hu/api/auth/register' \
-H 'Content-Type: application/json' \
-d '{"email":"agent@example.com","password":"choose-a-strong-password","account_type":"agent"}'
A resposta inclui api_token e approved_services. Em seguida:
curl -sS -X POST 'https://mcp.glc-rag.hu/mcp' \
-H 'Authorization: Bearer mcp_YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
| Recurso | URL |
|---|---|
| Guia do agente (HTML) | https://mcp.glc-rag.hu/guide/agent |
| Guia do agente (MD) | https://mcp.glc-rag.hu/guide/agent.md |
| Registro web | https://mcp.glc-rag.hu/register (marque Registrar como agente) |
| Índice de agentes | https://mcp.glc-rag.hu/llms.txt |
| Well-known | https://mcp.glc-rag.hu/.well-known/mcp |
| Endpoint MCP | https://mcp.glc-rag.hu/mcp |
Um administrador do sistema pode suspender um agente (bloqueia login + MCP) ou redefinir o acesso ao serviço para pending.
Registro de humanos
- Registre-se em
/register(conta humana) - Admin → solicite um serviço
- O administrador do sistema aprova
- Admin → crie um token de API
- Chame
/mcpcomAuthorization: Bearer mcp_...
Início rápido (servidor local)
# deps (once)
cd /home/pergel/mcp && /root/.local/bin/uv sync
# run
./scripts/run-server.sh
# -> http://127.0.0.1:8780
Inicialize o administrador do sistema (a partir de .env):
- email:
admin@mcp.local - senha:
ChangeMeAdmin1!
Layout
| Caminho | Função |
|---|---|
packages/core | identidade, protocolo MCP, gerador de documentação, criptografia |
packages/hello | serviço de teste hello_ping |
packages/geo | ferramentas MCP geo (somente leitura rag_dev.geo_entities) |
apps/mcp-server | integração FastAPI |
apps/web | SPA público / admin / system-admin |
infra/nginx | vhost para mcp.glc-rag.hu |
Bancos de dados
- App: PostgreSQL
MCP - Dados geo: PostgreSQL
rag_devem:5433(somente leitura via MCP)
Nginx
sudo cp /home/pergel/mcp/infra/nginx/mcp.glc-rag.hu.conf /etc/nginx/sites-available/
sudo ln -sf /etc/nginx/sites-available/mcp.glc-rag.hu.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
# TLS:
# sudo certbot --nginx -d mcp.glc-rag.hu
Systemd
sudo cp /home/pergel/mcp/infra/mcp-platform.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now mcp-platform