github / github/copilot-cli

Add support for an MCP server package type that resolves to a local executable

Open
#4,634 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

triage
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.