nextlevelbuilder/goclaw-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

12 stars 12 forks 质量 60 趋势 8

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

新手？先看 mcpskill.org 教程 →

配置

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