Skip to content

Conversation

@Starborn
Copy link

@Starborn Starborn commented Jan 9, 2026

Hi MCP Maintaners

I recently forked some files from the MCP Project and created the MCP Server Generator based on the specs to create an MCP server for . I'm excited about the project and wanted to explore how I might contribute it back to the MCP ecosystem. But it may not be a straight PR, because the code I am pushing back to the repo is not the same as the one I pulled from the repo for reference only

I'm a bit new to this, and I've already made one potentially confusing change: I renamed the generated directory from its default. I understand this might make a direct pull request challenging or unclear, and I apologize if that causes any confusion.
My app is not an MCP server, but a MCP server generator. It works,

My intention isn't to merge my specific server directly into the main repository, but rather to understand the process for adding a new, independent MCP server to the broader MCP project (perhaps in an 'examples' or 'community servers' section, if such a thing exists or is planned). I've seen other example servers, and I'd love to learn how to properly submit mine so it can be discovered and used by others, without cluttering the core repo.

Could you please guide me on the best practices or the correct process for contributing a new MCP server project, especially considering I've already made some local directory changes?

Here's a link to my repository if that helps: [Starborn:MCPservergen]

Thank you for your time and guidance!

Best regards,
[Your GitHub Username]

Description

Publishing Your Server

Note: We are no longer accepting PRs to add servers to the README. Instead, please publish your server to the MCP Server Registry to make it discoverable to the MCP ecosystem.

To publish your server, follow the quickstart guide. You can browse published servers at https://registry.modelcontextprotocol.io/.

Server Details

  • Server:
  • Changes to:

Motivation and Context

How Has This Been Tested?

Breaking Changes

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Protocol Documentation
  • 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
  • I have added appropriate error handling
  • I have documented all environment variables and configuration options

Additional context

@cliffhall
Copy link
Member

Hi @Starborn! Thanks for this, but we're not accepting unsolicited PRs for new reference servers at this time. Reference servers are created by the maintainers for the purpose of demonstrating and testing MCP specification features. Ongoing maintenance of the reference servers is an burden that we have to consider. Keeping them up to date with the SDK they are implemented in, responding to security issues, etc.

@cliffhall cliffhall closed this Jan 13, 2026
@Starborn
Copy link
Author

Starborn commented Jan 13, 2026 via email

@Starborn
Copy link
Author

Starborn commented Jan 13, 2026 via email

@cliffhall
Copy link
Member

Our focus is to provide SDKs for building servers and clients, reference servers for demonstrating spec features, and Inspectors (UI/CLI) that allow devs to test the servers they have built. That keeps us quite busy.

While it is interesting, a server generator is not really a tool we would currently want to shoulder the ongoing maintenance burden of. As time goes on, this would need continual updates to match the Python SDK's feature set, and some way of testing the output in CI to ensure that the servers it creates conform to spec and operate properly.

@olaservo @evalstate please weigh in if you have a different view on this, as I don't want to unilaterally make a decision that doesn't represent the other maintainers of this repo.

@Starborn
Copy link
Author

Starborn commented Jan 16, 2026 via email

@Starborn
Copy link
Author

Starborn commented Jan 17, 2026 via email

@cliffhall
Copy link
Member

Please point to the mechanism for server evaluation, how does the project ensure the servers it includes in the repo conform to spec?

There is a WIP conformance testing project, but I don't know if it is ready for prime time.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants