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"
      }
    }
  }
}