modelcontextprotocol / modelcontextprotocol/registry

How to convert a registry server.json into client configuration files (e.g. mcp.json, ~/.claude.json, .cursor/mcp.json)

Open
#749 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Go
Stars
7.3k
Forks
994
Avg merge
4d 12h
Merged PRs (30d)
19

Description

Hi team 👋,

I'm trying to understand how to convert a registry server.json (from the MCP registry format) into the configuration format used by different MCP-compatible clients — for example:

VS Code / GitHub Copilot Chat: mcp.json

Claude Code: ~/.claude.json

Cursor: .cursor/mcp.json

Currently, the registry server.json defines fields.
However, it’s not immediately clear how these map to the client configuration structure (e.g. the "type", "command", "args", "env", "url", "headers" fields in client configs).

Could you clarify:

Is there an official or recommended mapping between the server.json schema and the client configuration schema?

Are there any tools or scripts (official or community-maintained) to automate this conversion?

For remote servers (e.g. using sse or websocket), how should authentication headers or environment variables be handled in client configs?

An example mapping between a sample server.json and equivalent mcp.json / ~/.claude.json / .cursor/mcp.json entries would be especially helpful 🙏

Thanks in advance for your guidance — this would make it much easier to integrate registry MCP servers into different clients!

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 by comparing the registry server.json fields with the mentioned VS Code/Copilot mcp.json, Claude Code ~/.claude.json, and Cursor .cursor/mcp.json formats. Document whether an official mapping or conversion tool exists, including the remote-server authentication cases; done means a sample mapping and guidance for each client are provided.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.