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 자체에 obot-admin-mcp를 등록하고 해당 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개 항목).

구성

두 가지 환경 변수:

로컬 실행 (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 → 설정 → 커넥터 → 사용자 지정 커넥터 추가에 붙여넣으세요.

보안

부트스트랩/관리자 토큰은 호스트 도커 소켓을 마운트하는 obot에 대한 전체 제어 권한을 부여합니다. 이 토큰을 루트 자격 증명처럼 취급하십시오. 추가적인 인증 장벽(예: obot-connect/<id> 앞의 Cloudflare Access) 없이 공유/멀티 테넌트 obot에 obot-admin-mcp를 등록하지 마십시오.

라이선스

MIT