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.jsoncfromconfig/mcp/local-overrides.example.jsoncif 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.jsoncenables it and providesserverUrlplustoken
Copilot CLI Playwright is not generated here because Copilot CLI already ships a built-in Playwright MCP server.