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":{}}'
RecursoURL
Guia do agente (HTML)https://mcp.glc-rag.hu/guide/agent
Guia do agente (MD)https://mcp.glc-rag.hu/guide/agent.md
Registro webhttps://mcp.glc-rag.hu/register (marque Registrar como agente)
Índice de agenteshttps://mcp.glc-rag.hu/llms.txt
Well-knownhttps://mcp.glc-rag.hu/.well-known/mcp
Endpoint MCPhttps://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

  1. Registre-se em /register (conta humana)
  2. Admin → solicite um serviço
  3. O administrador do sistema aprova
  4. Admin → crie um token de API
  5. Chame /mcp com Authorization: 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

CaminhoFunção
packages/coreidentidade, protocolo MCP, gerador de documentação, criptografia
packages/helloserviço de teste hello_ping
packages/geoferramentas MCP geo (somente leitura rag_dev.geo_entities)
apps/mcp-serverintegração FastAPI
apps/webSPA público / admin / system-admin
infra/nginxvhost para mcp.glc-rag.hu

Bancos de dados

  • App: PostgreSQL MCP
  • Dados geo: PostgreSQL rag_dev em :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