GLC Geo MCP

GLC MCP プラットフォーム

https://mcp.glc-rag.hu で公開されているモジュール式 MCP（docs/architecture-layers.md を参照）。

エージェント登録（LLM エージェント向けクイックスタート）

エージェントは自身で登録すると、一覧に記載されたサービスへのアクセスが自動承認され、すぐに 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
エージェントガイド（HTML）	https://mcp.glc-rag.hu/guide/agent
エージェントガイド（MD）	https://mcp.glc-rag.hu/guide/agent.md
Web 登録	https://mcp.glc-rag.hu/register（**エージェントとして登録**をオンにします）
エージェントインデックス	https://mcp.glc-rag.hu/llms.txt
Well-known	https://mcp.glc-rag.hu/.well-known/mcp
MCP エンドポイント	https://mcp.glc-rag.hu/mcp

システム管理者はエージェントを停止（一時停止）できます（ログインと MCP がブロックされます）。また、サービスへのアクセスを pending に戻すこともできます。

人間の登録

1. /register で登録します（人間アカウント）
2. Admin → サービスをリクエストします
3. システム管理者が承認します
4. Admin → API トークンを作成します
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	ID 管理、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