Files

1.4 KiB

MCP Notes

This repository manages shared MCP configuration through tracked templates plus machine-local overrides.

What Is Tracked

  • Shared templates live in config/mcp/.
  • The merge logic lives in install/merge-managed-mcp-config.mjs.
  • The Copilot CLI filesystem wrapper lives in install/mcp/.

What Stays Local

  • Machine-local values live in .local/mcp.local.jsonc.
  • Secrets stay in that local file and are never committed.
  • Bootstrap creates .local/mcp.local.jsonc from config/mcp/local-overrides.example.jsonc if it does not exist yet.

Generated Outputs

  • VS Code user MCP config: user-profile mcp.json
  • Copilot CLI user MCP config: ~/.copilot/mcp-config.json

Bootstrap and update regenerate those managed files while preserving unmanaged entries already present in the user config.

Managed Servers

  • Playwright: generated for VS Code with npx @playwright/mcp@latest
  • Filesystem: generated for VS Code with Docker and ${workspaceFolder} binding
  • Filesystem: generated for Copilot CLI with a repo-owned Node wrapper that binds the current working directory into Docker
  • Gitea/Forgejo: generated for VS Code and Copilot CLI with ronmi/forgejo-mcp, but only when .local/mcp.local.jsonc enables it and provides serverUrl plus token

Copilot CLI Playwright is not generated here because Copilot CLI already ships a built-in Playwright MCP server.