nextlevelbuilder/goclaw-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

12 stars 12 forks 품질 60 트렌드 19

Repository Install

MCP server for GoClaw Gateway server management

개요

MCP (Model Context Protocol) server for GoClaw Gateway server management. Enables AI assistants like Claude, Cursor, and other MCP clients to manage your GoClaw AI gateway infrastructure. - covering all GoClaw management operations - for real-time gateway context - for guided workflows - : stdio (local) + Streamable HTTP (production) - : audit logging, rate limiting, secret scrubbing, origin validation - : Full TypeScript with Zod schema validation - — Tokens, API keys, passwords never appear in logs - — Every tool invocation logged with structured JSON - — Token bucket per session (HTTP transport) - — DNS rebinding prevention - — Zod schemas on all tool parameters - — Bearer token forwarded to GoClaw RBAC

README

원문 README의 일부입니다. 원문 보기.

goclaw-mcp

MCP (Model Context Protocol) server for GoClaw Gateway server management. Enables AI assistants like Claude, Cursor, and other MCP clients to manage your GoClaw AI gateway infrastructure.

Features

66 MCP tools covering all GoClaw management operations
4 MCP resources for real-time gateway context
4 MCP prompts for guided workflows
Dual transport: stdio (local) + Streamable HTTP (production)
Enterprise security: audit logging, rate limiting, secret scrubbing, origin validation
Type-safe: Full TypeScript with Zod schema validation

Quick Start

stdio (Claude Code, Cursor, etc.)

npx goclaw-mcp

Add to your MCP client config:

Claude Code (~/.claude.json):

{
  "mcpServers": {
    "goclaw": {
      "command": "npx",
      "args": ["goclaw-mcp"],
      "env": {
        "GOCLAW_SERVER": "http://localhost:8080",
        "GOCLAW_TOKEN": "your-admin-token"
      }
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "goclaw": {
      "command": "npx",
      "args": ["goclaw-mcp"],
      "env": {
        "GOCLAW_SERVER": "http://localhost:8080",
        "GOCLAW_TOKEN": "your-admin-token"
      }
    }
  }
}

Streamable HTTP (production, multi-client)

GOCLAW_SERVER=http://localhost:8080 \
GOCLAW_TOKEN=your-token \
GOCLAW_MCP_PORT=3100 \
npx goclaw-mcp-http

MCP endpoint: http://localhost:3100/mcp

Configuration

Variable	Required	Default	Description
`GOCLAW_SERVER`	Yes	—	GoClaw gateway URL
`GOCLAW_TOKEN`	No	—	Bearer token (determines RBAC role)
`GOCLAW_USER_ID`	No	—	Default user ID for multi-tenant scoping
`GOCLAW_MCP_PORT`	No	`3100`	HTTP transport port
`GOCLAW_MCP_ALLOWED_ORIGINS`	No	`localhost`	Comma-separated allowed origins
`GOCLAW_MCP_RATE_LIMIT_RPM`	No	`60`	Rate limit per session (req/min)
`GOCLAW_LOG_LEVEL`	No	`info`	Log level: debug, info, warn, error

Available Tools

System (3)

Tool	Description
`goclaw_health`	Check gateway health
`goclaw_status`	Get gateway status
`goclaw_models_list`	List available LLM models

Agents (13)

Tool	Description
`goclaw_agent_list`	List all agents
`goclaw_agent_get`	Get agent details
`goclaw_agent_create`	Create agent
`goclaw_agent_update`	Update agent
`goclaw_agent_delete`	Delete agent
`goclaw_agent_files_list`	List context files
`goclaw_agent_files_get`	Read context file
`goclaw_agent_files_set`	Write context file
`goclaw_agent_files_delete`	Delete context file
`goclaw_agent_links_list`	List delegation links
`goclaw_agent_links_set`	Set delegation link
`goclaw_agent_links_remove`	Remove delegation link

GitHub에서 전체 README 보기

설치

npx goclaw-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "goclaw": {
      "command": "npx",
      "args": ["goclaw-mcp"],
      "env": {
        "GOCLAW_SERVER": "http://localhost:8080",
        "GOCLAW_TOKEN": "your-admin-token"
      }
    }
  }
}