xworkspace-console/docs/en/local-mcp-debug.md
Haitao Pan 029ef9fc13 chore(mcp): add local MCP debug tooling (github/terraform/ssh servers)
Local MCP debug setup: launcher scripts, config, setup script, and EN/ZH docs.
Secrets live in config/mcp/local-mcp.env (gitignored); commit a sanitized
local-mcp.env.example template instead.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-25 22:56:43 +08:00

1.0 KiB

Local MCP Debug Pack

This pack is tuned for local debugging with a small tool surface.

Included

  • github-mcp-server
  • terraform-mcp-server
  • mcp-ssh-manager
  • ansible.mcp as an Ansible collection dependency, not a standalone MCP daemon

One-step setup

cd /Users/shenlan/workspaces/ai-workspace-lab/xworkspace-console
./scripts/setup-local-mcp-debug.sh

The script writes:

  • /Users/shenlan/workspaces/ai-workspace-lab/xworkspace-console/config/mcp/local-mcp-config.json
  • /Users/shenlan/workspaces/ai-workspace-lab/xworkspace-console/config/mcp/local-mcp.env
  • /Users/shenlan/workspaces/ai-workspace-lab/xworkspace-console/config/mcp/bin/*.sh
  • GitHub MCP stays on the minimal default toolset
  • Terraform MCP stays on registry
  • SSH Manager runs through npx to avoid a global install
  • The GitHub token stays local in local-mcp.env

Required env vars

  • GITHUB_PERSONAL_ACCESS_TOKEN
  • TFC_TOKEN only if you need Terraform Cloud / Enterprise access