Skip to content

README.md

Latest commit

 

History

History
83 lines (58 loc) · 3.04 KB

README.md

File metadata and controls

83 lines (58 loc) · 3.04 KB

📚 MCP Server Registry

The MCP Server Registry is a central repository of Model Context Protocol servers. This registry enables easy discovery and installation of MCP servers for clients like Claude Desktop, Cursor, and Windsurf.

Status: Active Contributions: Welcome

🤔 What is MCP?

Model Context Protocol (MCP) is a standard for building LLM-powered tools. It enables language models to use external tools, resources, and capabilities in a standardized way.

  • 🔄 Standard Interface: Common protocol for LLMs to interact with tools
  • 🧩 Composable: Mix and match tools from different providers
  • 🚀 Portable: Works across different clients and environments

🧰 How to Use This Registry

🔍 Browsing Servers

Browse the servers directory to find MCP servers that match your needs. Each server has its own directory with:

  • 📄 [server-name].json - Configuration details including endpoint, capabilities, and version
  • 📝 README.md - Documentation with usage examples and requirements
  • 🧪 Examples folder (optional)

⬇️ Installing Servers

You can install servers from this registry using:

  1. MCPM: Our recommended tool

    # Install a server by name
mcpm add server-name

  2. Manual Configuration: Add the server URL directly to your MCP client's configuration

🤝 Contributing Your Server

We welcome contributions! There are two ways to add your server to the registry:

1. Create a GitHub Issue (Easiest)

Simply create a new GitHub issue with:

  • Title: "Add server: [your-server-name]"
  • Body: URL to your server details or API documentation
  • We'll automatically generate the necessary files and create a PR for you

2. Submit a Pull Request

For more control over your submission:

  1. Fork this repository
  2. Create a JSON file in mcp-registry/servers/ named [your-server-name].json. The JSON should follow our schema
  3. Validate locally to ensure correct schema 
    python scripts/validate_manifest.py | grep "your-server-name"
    If validation succeeds, you should see: 
    ✓ your-server-name: Valid
  4. Submit a pull request

📂 Registry Structure

mcp-registry/
├── README.md               # Overview, usage instructions
├── servers/                # Directory containing all registered servers
│   ├── [server-1-name].json   # Server metadata and configuration
│   ├── [server-2-name].json   
│   └── ...
└── schema/                 # Schema definitions
    └── server-schema.json  # JSON Schema for server validation

📜 License

This registry is licensed under the MIT License - see the LICENSE file for details.