obot-admin-mcp

MCPクライアント（claude.ai、Claude Desktopなど）が、REST API経由でセルフホスト型のobot MCPゲートウェイを管理できるようにするMCPサーバーです。これを使用すると、チャットクライアント内からobot内のMCPサーバーのインストール、一覧表示、検査、削除を行うことができます。

目的

obotは、登録された各MCPサーバーを https://<obot-host>/mcp-connect/<id> として公開します。通常、新しいMCPサーバーをインストールするには、obotのREST APIまたは管理UIにアクセスする必要があります。このパッケージは関連するエンドポイントをMCPツールとしてラップしているため、一度 obot-admin-mcp をobot自体に登録し、その connectURL をclaude.aiに接続すれば、Claudeに「n8n MCPをインストールして」や「obotにあるすべてのサーバーを一覧表示して」と頼むだけで実行できるようになります。

ツール

• list_mcp_servers — id、name、runtime、configured-state、connectURL を取得します。

• get_mcp_server(id) — 完全なマニフェスト、env、不足している必須変数を確認します。

• add_npx_mcp(name, package, env?, sensitiveKeys?, shortDescription?, alias?) — npmで公開されているstdio MCPをインストールします。

• add_remote_mcp(name, url, shortDescription?, alias?) — リモートのHTTP/SSE MCPを登録します。

• delete_mcp_server(id) — obotからMCPを削除します。

• list_catalog_entries(search?) — obotのカタログを閲覧します（デフォルトで81件）。

設定

2つの環境変数が必要です：

ローカルでの実行（Claude Desktop / 開発用）

このリポジトリから直接インストールします（npm公開は不要です。ビルド済みの dist/ がコミットされています）：

{
  "mcpServers": {
    "obot-admin": {
      "command": "npx",
      "args": ["-y", "github:kiarashedraki/obot-admin-mcp"],
      "env": {
        "OBOT_URL": "https://obot.edraki.me",
        "OBOT_TOKEN": "<your-token>"
      }
    }
  }
}

obot内での登録（メタループ）

curl -X POST https://obot.edraki.me/api/mcp-servers \
  -H "Authorization: Bearer $OBOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "manifest": {
      "name": "obot-admin",
      "shortDescription": "Manage obot itself",
      "runtime": "npx",
      "npxConfig": { "package": "obot-admin-mcp" },
      "env": [
        { "key": "OBOT_URL",   "value": "https://obot.edraki.me", "required": true,  "sensitive": false },
        { "key": "OBOT_TOKEN", "value": "<token>",                "required": true,  "sensitive": true  }
      ]
    },
    "alias": "obot-admin"
  }'

レスポンスには connectURL が含まれています。これを claude.ai → 設定 → コネクタ → カスタムコネクタの追加 に貼り付けてください。

セキュリティ

ブートストラップ/管理トークンは、ホストのdockerソケットをマウントするobotの完全な制御権を与えます。このトークンはルート権限の認証情報として扱ってください。追加の認証壁（例：obot-connect/<id> の手前にCloudflare Accessを配置するなど）なしで、共有/マルチテナントのobotに obot-admin-mcp を登録しないでください。

ライセンス

MIT