GLC Geo MCP

GLC MCP 平台

公共模块化 MCP，网址为 **https://mcp.glc-rag.hu**（参见 docs/architecture-layers.md）。

Agent 注册（LLM Agent 快速入门）

Agent 可自行注册，自动获批访问所列服务，并立即收到 api_token。

curl -sS -X POST 'https://mcp.glc-rag.hu/api/auth/register' \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","password":"choose-a-strong-password","account_type":"agent"}'

响应中包含 api_token 和 approved_services。然后：

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":{}}'

资源	URL
Agent 指南（HTML）	https://mcp.glc-rag.hu/guide/agent
Agent 指南（MD）	https://mcp.glc-rag.hu/guide/agent.md
网页注册	https://mcp.glc-rag.hu/register（勾选 注册为 Agent）
Agent 索引	https://mcp.glc-rag.hu/llms.txt
Well-known	https://mcp.glc-rag.hu/.well-known/mcp
MCP 端点	https://mcp.glc-rag.hu/mcp

系统管理员可以暂停 Agent（阻止登录和使用 MCP），或将服务访问权限重置为 pending。

人工注册

1. 在 /register 注册（人工账号）
2. 管理员 → 请求服务
3. 系统管理员审批
4. 管理员 → 创建 API token
5. 使用 Authorization: Bearer mcp_... 调用 /mcp

快速入门（本地服务）

# deps (once)
cd /home/pergel/mcp && /root/.local/bin/uv sync

# run
./scripts/run-server.sh
# -> http://127.0.0.1:8780

使用 .env 引导创建系统管理员：

• 邮箱：[email protected]
• 密码：ChangeMeAdmin1!

目录结构

路径	作用
packages/core	身份管理、MCP 协议、文档生成器、加密
packages/hello	hello_ping 冒烟测试服务
packages/geo	geo MCP 工具（只读访问 rag_dev.geo_entities）
apps/mcp-server	FastAPI 接线
apps/web	公共 / 管理员 / 系统管理员 SPA
infra/nginx	mcp.glc-rag.hu 的虚拟主机配置

数据库

• 应用：PostgreSQL MCP
• 地理数据：:5433 上的 PostgreSQL rag_dev（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