English Français العربية

GLC Geo MCP

السجل الرسمي الخرائط والسفر والطقس

Free GeoNames MCP: countries, cities, POIs, distance & nearby. Remote HTTP + agent token signup.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http glc-geo-mcp 'https://mcp.glc-rag.hu/mcp' --header 'Authorization: <Bearer mcp_… API token. Agents: POST https://mcp.glc-rag.hu/api/auth/register with account_type=agent.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "glc-geo-mcp": {
            "type": "http",
            "url": "https://mcp.glc-rag.hu/mcp",
            "headers": {
                "Authorization": "<Bearer mcp_… API token. Agents: POST https://mcp.glc-rag.hu/api/auth/register with account_type=agent.>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. GLC MCP Platform
  2. Agent registration (quick start for LLM agents)
  3. Human registration
  4. Quick start (local server)
  5. Layout
  6. Databases
  7. Nginx
  8. Systemd

GLC MCP Platform

Public modular MCP at **https://mcp.glc-rag.hu** (see docs/architecture-layers.md).

Agent registration (quick start for LLM agents)

Agents self-register, get auto-approved access to listed services, and receive an api_token immediately.

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

Response includes api_token and approved_services. Then:

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":{}}'
ResourceURL
Agent guide (HTML)https://mcp.glc-rag.hu/guide/agent
Agent guide (MD)https://mcp.glc-rag.hu/guide/agent.md
Web registerhttps://mcp.glc-rag.hu/register (check Register as agent)
Agent indexhttps://mcp.glc-rag.hu/llms.txt
Well-knownhttps://mcp.glc-rag.hu/.well-known/mcp
MCP endpointhttps://mcp.glc-rag.hu/mcp

A system admin can suspend an agent (blocks login + MCP) or set service access back to pending.

Human registration

  1. Register at /register (human account)
  2. Admin → request a service
  3. System admin approves
  4. Admin → create API token
  5. Call /mcp with Authorization: Bearer mcp_...

Quick start (local server)

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

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

Bootstrap system-admin (from .env):

  • email: admin@mcp.local
  • password: ChangeMeAdmin1!

Layout

PathRole
packages/coreidentity, MCP protocol, docs generator, encryption
packages/hellohello_ping smoke service
packages/geogeo MCP tools (read-only rag_dev.geo_entities)
apps/mcp-serverFastAPI wiring
apps/webpublic / admin / system-admin SPA
infra/nginxvhost for mcp.glc-rag.hu

Databases

  • App: PostgreSQL MCP
  • Geo data: PostgreSQL rag_dev on :5433 (read-only from 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

الأسئلة الشائعة

ما هو GLC Geo MCP؟

Free GeoNames MCP: countries, cities, POIs, distance & nearby. Remote HTTP + agent token signup.

كيف أثبّت GLC Geo MCP؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http glc-geo-mcp 'https://mcp.glc-rag.hu/mcp' --header 'Authorization: <Bearer mcp_… API token. Agents: POST https://mcp.glc-rag.hu/api/auth/register with account_type=agent.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج GLC Geo MCP إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل GLC Geo MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون GLC Geo MCP؟

ينشره glc-rag. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.