Add support for an MCP server package type that resolves to a local executable
Nobody has claimed this yet.
- Dominant language
- Shell
- Stars
- 11.2k
- Forks
- 1.9k
- Avg merge
- 14h 16m
- Merged PRs (30d)
- 6
Description
Describe the feature or problem you'd like to solve
When using an MCP registry that includes an MCP server pointing to a local exe, there is no way to have Copilot install it correctly. Only npm, pypi, oci and docker are supported as "registry type"
Proposed solution
We have MCP servers served as simple binaries. Those are documented in our MCP registry (configured in Azure API Center and enforced through GitHub Copilot Enterprise).
To be able to install those MCP servers using copilot (eg /mcp search ...) correctly, copilot should support a new "registryType" in addition to the existing ones (npm, pypi, oci, docker).
This could be something like "none" or "executable", etc.
The expected behavior would be that if the MCP registry lists an MCP server with the new registry type (none, executable, etc), copilot would add the MCP server in mcp-config.json, fully respecting the MCP registry definition and thus pointing to the executable and NOT using npx, uvx, etc as it currently does.
For reference, here's the analysis of the problematic part of copilot's codebase:
Analyzed the CLI's bundled app.js . Found the exact logic (functions umi / cmi in the MCP-registry install module):
Root cause: Copilot CLI's registry→launch-config converter only supports 4 hardcoded registryType s, each mapped to a fixed launcher — there's no "binary/exe" package type at all:
switch (t.registryType) {
case "npm": n.push("npx"), ..., n.push("-y"), n.push(identifier[@version]); break;
case "pypi": n.push("uvx"), ..., n.push(identifier); break;
case "oci":
case "docker": n.push("docker","run","--rm","-i"), ...; break;
default: throw new Error(`Unsupported package type: ${t.registryType}`);
}
And a supportability gate: ["npm","pypi","oci","docker"].includes(registryType) — anything else is rejected as "not yet supported."
What this means for you: if your registry's GitLab MCP entry has registryType: "npm" , Copilot always synthesizes npx -y <identifier>@<version> — it never reads or honors a custom "command/exe path" field from the registry package object, regardless of what your registry intends. There's a separate commandToRegistryType map (npx→npm, uvx→pypi, dotnet→nuget, docker→docker, brew→homebrew, mcpb→mcpb) used for fingerprinting, but the actual launch-builder ( umi ) doesn't implement nuget/homebrew/mcpb either — only npm/pypi/oci/docker.
Bottom line: there's currently no supported registry package type that resolves to a raw local executable path. To point at your exe you'd need to bypass /mcp search / /mcp add -from-registry and instead manually add the server ( /mcp add with explicit command, or edit the MCP config file directly) with command: "C:\path\to\gitlab-mcp.exe"
Example prompts or workflows
No response
Additional context
No response
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start in the bundled app.js at the MCP-registry install functions umi and cmi, including the registryType supportability gate and launch-command switch. Trace how the /mcp search and /mcp add-from-registry entry points produce mcp-config.json. Done means a documented executable registry type is accepted and the resulting configuration points directly to the registry's local executable instead of using npx, uvx, or Docker.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- shell
- Domain
- cli
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100