From 787def6fa3a8ca671be8fe828fe1b391274c68ea Mon Sep 17 00:00:00 2001 From: olaservo Date: Sun, 23 Nov 2025 11:23:48 -0700 Subject: [PATCH 1/8] docs: update PR template to deprecate README and promote MCP Registry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Updated pull request template to inform contributors that adding servers to the README is deprecated. Contributors should now publish servers to the MCP Server Registry instead, following the quickstart guide. Changes: - Added "Publishing Your Server" section with deprecation notice - Updated checklist to include MCP Registry publishing - Clarified README item refers to server's own documentation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .github/pull_request_template.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 5fbe8a15b5..503e72391d 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -2,6 +2,12 @@ ## Description +## Publishing Your Server + +**Note: Adding servers to the README is now deprecated.** Instead, please publish your server to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) to make it discoverable to the MCP ecosystem. + +To publish your server, follow the [quickstart guide starting from the "Install MCP Publisher" step](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx#step-3-install-mcp-publisher). + ## Server Details - Server: @@ -27,7 +33,8 @@ - [ ] I have read the [MCP Protocol Documentation](https://modelcontextprotocol.io) - [ ] My changes follows MCP security best practices -- [ ] I have updated the server's README accordingly +- [ ] I have published my server to the MCP Server Registry (recommended for new servers) +- [ ] I have updated the server's own README with documentation - [ ] I have tested this with an LLM client - [ ] My code follows the repository's style guidelines - [ ] New and existing tests pass locally From ff661562dac9a39b53b2949428ff24997f9f33f0 Mon Sep 17 00:00:00 2001 From: olaservo Date: Sun, 23 Nov 2025 11:58:50 -0700 Subject: [PATCH 2/8] docs: update documentation to deprecate README server listings and promote MCP Server Registry --- .github/pull_request_template.md | 4 ++-- CONTRIBUTING.md | 8 +++++--- README.md | 3 +++ 3 files changed, 10 insertions(+), 5 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 503e72391d..cc0c7fbbc1 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -4,9 +4,9 @@ ## Publishing Your Server -**Note: Adding servers to the README is now deprecated.** Instead, please publish your server to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) to make it discoverable to the MCP ecosystem. +**Note: We are no longer accepting PRs to add servers to the README.** Instead, please publish your server to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) to make it discoverable to the MCP ecosystem. -To publish your server, follow the [quickstart guide starting from the "Install MCP Publisher" step](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx#step-3-install-mcp-publisher). +To publish your server, follow the [quickstart guide starting from the "Install MCP Publisher" step](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx#step-3-install-mcp-publisher). You can browse published servers at [https://registry.modelcontextprotocol.io/](https://registry.modelcontextprotocol.io/). ## Server Details diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 932b25991a..24713136ad 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -6,7 +6,9 @@ We accept changes through [the standard GitHub flow model](https://docs.github.c ## Server Listings -We welcome PRs that add links to your servers in the [README.md](./README.md)! +We are **no longer accepting PRs** to add server links to the README. Please publish your server to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) instead. Follow the [quickstart guide starting from the "Install MCP Publisher" step](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx#step-3-install-mcp-publisher). + +You can browse published servers using the simple UI at [https://registry.modelcontextprotocol.io/](https://registry.modelcontextprotocol.io/). ## Server Implementations @@ -16,10 +18,10 @@ We welcome: - **Enhancements that demonstrate MCP protocol features** — We encourage contributions that help reference servers better illustrate underutilized aspects of the MCP protocol beyond just Tools, such as Resources, Prompts, or Roots. For example, adding Roots support to filesystem-server helps showcase this important but lesser-known feature. We're more selective about: -- **Other new features** — Especially if they're not crucial to the server's core purpose or are highly opinionated. The existing servers are reference servers meant to inspire the community. If you need specific features, we encourage you to build enhanced versions! We think a diverse ecosystem of servers is beneficial for everyone, and would love to link to your improved server in our README. +- **Other new features** — Especially if they're not crucial to the server's core purpose or are highly opinionated. The existing servers are reference servers meant to inspire the community. If you need specific features, we encourage you to build enhanced versions and publish them to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry)! We think a diverse ecosystem of servers is beneficial for everyone. We don't accept: -- **New server implementations** — We encourage you to publish them yourself, and link to them from the README. +- **New server implementations** — We encourage you to publish them to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) instead. ## Testing diff --git a/README.md b/README.md index 40053069d6..1cb18bcf5b 100644 --- a/README.md +++ b/README.md @@ -19,6 +19,9 @@ Typically, each MCP server is implemented with an MCP SDK: > [!NOTE] > Lists in this README are maintained in alphabetical order to minimize merge conflicts when adding new items. +> [!IMPORTANT] +> **We are no longer accepting PRs to add servers to this README.** Please publish your server to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) instead by following the [quickstart guide](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx#step-3-install-mcp-publisher). The registry provides better discoverability and a streamlined publishing process for the MCP ecosystem. You can browse published servers at [https://registry.modelcontextprotocol.io/](https://registry.modelcontextprotocol.io/). + ## 🌟 Reference Servers These servers aim to demonstrate MCP features and the official SDKs. From 107c9ac574a2419009a8c515169e063a589093a0 Mon Sep 17 00:00:00 2001 From: olaservo Date: Sun, 23 Nov 2025 12:02:53 -0700 Subject: [PATCH 3/8] docs: remove checklist items for server publishing and README updates in PR template --- .github/pull_request_template.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index cc0c7fbbc1..4ccb4be23b 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -33,8 +33,6 @@ To publish your server, follow the [quickstart guide starting from the "Install - [ ] I have read the [MCP Protocol Documentation](https://modelcontextprotocol.io) - [ ] My changes follows MCP security best practices -- [ ] I have published my server to the MCP Server Registry (recommended for new servers) -- [ ] I have updated the server's own README with documentation - [ ] I have tested this with an LLM client - [ ] My code follows the repository's style guidelines - [ ] New and existing tests pass locally From 8da640d9e129618548e3f2d23d2d36652de007e4 Mon Sep 17 00:00:00 2001 From: olaservo Date: Sun, 23 Nov 2025 12:04:19 -0700 Subject: [PATCH 4/8] docs: add checklist item to confirm README updates in PR template --- .github/pull_request_template.md | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 4ccb4be23b..a615af653f 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -33,6 +33,7 @@ To publish your server, follow the [quickstart guide starting from the "Install - [ ] I have read the [MCP Protocol Documentation](https://modelcontextprotocol.io) - [ ] My changes follows MCP security best practices +- [ ] I have updated the server's README accordingly - [ ] I have tested this with an LLM client - [ ] My code follows the repository's style guidelines - [ ] New and existing tests pass locally From ad7126c6e99c597e90c155624f09c8866b9619cb Mon Sep 17 00:00:00 2001 From: Ola Hungerford Date: Mon, 24 Nov 2025 20:39:40 -0700 Subject: [PATCH 5/8] Update README.md Co-authored-by: Cliff Hall --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1cb18bcf5b..5b1f586826 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ Typically, each MCP server is implemented with an MCP SDK: - [TypeScript MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk) > [!NOTE] -> Lists in this README are maintained in alphabetical order to minimize merge conflicts when adding new items. +The server lists in this README are no longer maintained and will eventually be removed. > [!IMPORTANT] > **We are no longer accepting PRs to add servers to this README.** Please publish your server to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) instead by following the [quickstart guide](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx#step-3-install-mcp-publisher). The registry provides better discoverability and a streamlined publishing process for the MCP ecosystem. You can browse published servers at [https://registry.modelcontextprotocol.io/](https://registry.modelcontextprotocol.io/). From c60cfc76a791f03a1c35934f67647cd88b386fea Mon Sep 17 00:00:00 2001 From: Ola Hungerford Date: Mon, 24 Nov 2025 20:39:51 -0700 Subject: [PATCH 6/8] Update README.md Co-authored-by: Tadas Antanavicius --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index 5b1f586826..06281bf172 100644 --- a/README.md +++ b/README.md @@ -20,8 +20,7 @@ Typically, each MCP server is implemented with an MCP SDK: The server lists in this README are no longer maintained and will eventually be removed. > [!IMPORTANT] -> **We are no longer accepting PRs to add servers to this README.** Please publish your server to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) instead by following the [quickstart guide](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx#step-3-install-mcp-publisher). The registry provides better discoverability and a streamlined publishing process for the MCP ecosystem. You can browse published servers at [https://registry.modelcontextprotocol.io/](https://registry.modelcontextprotocol.io/). - +> If you are looking for a list of MCP servers, you can browse published servers on [the MCP Registry](https://registry.modelcontextprotocol.io/). The repository served by this README is dedicated to housing just the small number of reference servers maintained by the MCP steering group. ## 🌟 Reference Servers These servers aim to demonstrate MCP features and the official SDKs. From 6bedb90a5d82122a63e8ae5947b53c8b847df7f8 Mon Sep 17 00:00:00 2001 From: olaservo Date: Mon, 24 Nov 2025 20:48:59 -0700 Subject: [PATCH 7/8] Rearrange notes --- README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 06281bf172..c76bda9b6e 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,9 @@ This repository is a collection of *reference implementations* for the [Model Context Protocol](https://modelcontextprotocol.io/) (MCP), as well as references to community-built servers and additional resources. +> [!IMPORTANT] +> If you are looking for a list of MCP servers, you can browse published servers on [the MCP Registry](https://registry.modelcontextprotocol.io/). The repository served by this README is dedicated to housing just the small number of reference servers maintained by the MCP steering group. + The servers in this repository showcase the versatility and extensibility of MCP, demonstrating how it can be used to give Large Language Models (LLMs) secure, controlled access to tools and data sources. Typically, each MCP server is implemented with an MCP SDK: @@ -16,11 +19,6 @@ Typically, each MCP server is implemented with an MCP SDK: - [Swift MCP SDK](https://github.com/modelcontextprotocol/swift-sdk) - [TypeScript MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk) -> [!NOTE] -The server lists in this README are no longer maintained and will eventually be removed. - -> [!IMPORTANT] -> If you are looking for a list of MCP servers, you can browse published servers on [the MCP Registry](https://registry.modelcontextprotocol.io/). The repository served by this README is dedicated to housing just the small number of reference servers maintained by the MCP steering group. ## 🌟 Reference Servers These servers aim to demonstrate MCP features and the official SDKs. @@ -53,6 +51,9 @@ The following reference servers are now archived and can be found at [servers-ar ## 🤝 Third-Party Servers +> [!NOTE] +The server lists in this README are no longer maintained and will eventually be removed. + ### 🎖️ Official Integrations Official integrations are maintained by companies building production ready MCP servers for their platforms. From 92dbd9fd84deca7be9e020302d9f6c8c10fa13d0 Mon Sep 17 00:00:00 2001 From: olaservo Date: Tue, 25 Nov 2025 08:27:00 -0700 Subject: [PATCH 8/8] docs: simplify quickstart guide links MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Address review feedback from @domdomegg to simplify the quickstart links by removing the anchor to a specific step. Users should see the full quickstart including verification, and simpler links are more robust if docs reorganize. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .github/pull_request_template.md | 2 +- CONTRIBUTING.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index a615af653f..dd93c47980 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -6,7 +6,7 @@ **Note: We are no longer accepting PRs to add servers to the README.** Instead, please publish your server to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) to make it discoverable to the MCP ecosystem. -To publish your server, follow the [quickstart guide starting from the "Install MCP Publisher" step](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx#step-3-install-mcp-publisher). You can browse published servers at [https://registry.modelcontextprotocol.io/](https://registry.modelcontextprotocol.io/). +To publish your server, follow the [quickstart guide](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx). You can browse published servers at [https://registry.modelcontextprotocol.io/](https://registry.modelcontextprotocol.io/). ## Server Details diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 24713136ad..ab15fc928f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -6,7 +6,7 @@ We accept changes through [the standard GitHub flow model](https://docs.github.c ## Server Listings -We are **no longer accepting PRs** to add server links to the README. Please publish your server to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) instead. Follow the [quickstart guide starting from the "Install MCP Publisher" step](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx#step-3-install-mcp-publisher). +We are **no longer accepting PRs** to add server links to the README. Please publish your server to the [MCP Server Registry](https://github.com/modelcontextprotocol/registry) instead. Follow the [quickstart guide](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx). You can browse published servers using the simple UI at [https://registry.modelcontextprotocol.io/](https://registry.modelcontextprotocol.io/).