diff --git a/docs/mcp/mcp-marketplace.mdx b/docs/mcp/mcp-marketplace.mdx index 36707a20c8..f576ea4737 100644 --- a/docs/mcp/mcp-marketplace.mdx +++ b/docs/mcp/mcp-marketplace.mdx @@ -1,5 +1,5 @@ --- -title: "MCP Made Easy" +title: "MCP Made Easy w/ MCP Marketplace" description: "Learn how to use the MCP Marketplace to discover, install, and configure MCP servers that enhance Cline's capabilities with additional tools and resources." --- @@ -9,7 +9,13 @@ MCP servers are specialized extensions that enhance Cline's capabilities. They e ## MCP Marketplace Walkthrough -The MCP Marketplace provides a one-click installation experience for hundreds of MCP servers across various categories. +The MCP Marketplace is a curated collection of MCP servers that makes discovery and installation easy. With the marketplace, you can: + +- Browse official and community-made MCP servers +- Search by name, category, tags, and other metadata +- Install MCP servers with one click, triggering Cline to autonomously handle cloning, setup, and configuration. + +By following the steps outlined below, you can quickly get started: ### 1. Access the Marketplace @@ -130,7 +136,7 @@ If you're getting an error when using an MCP server, you can try the following: Cline is already aware of your active MCP servers and what they are for, but when you have a lot of MCP servers enabled, it can be useful to define when to use each server. -Utilize a `.clinerules` file or custom instructions to support intelligent MCP server activation through keyword-based triggers, making Cline's tool selection more intuitive and context-aware. +Utilize a `.clinerules` file to support intelligent MCP server activation through keyword-based triggers, making Cline's tool selection more intuitive and context-aware. ### How MCP Rules Work @@ -196,4 +202,40 @@ For finance tasks like "What's Apple's stock price?", keywords like "stock" and } ``` -Add this to your `.clinerules` file or to your custom instructions to make Cline's MCP server selection more intuitive and context-aware. +Add this to your `.clinerules` file to make Cline's MCP server selection more intuitive and context-aware. + +## How to Add Your MCP Server to the MCP Marketplace + +### MCP Server Submission + +1. Create a [new issue](https://github.com/cline/mcp-marketplace/issues/new?template=mcp-server-submission.yml) in the Cline `cline/mcp-marketplace` repository +2. **Include the Following Info** in the Issue: + - **GitHub Repo URL:** A direct link to the MCP server’s repository (nested links are also okay like in this [example](https://github.com/modelcontextprotocol/servers/tree/main/src/github)) + - **Logo Image:** A 400×400 PNG that will serve as your server’s icon. + - **Reason for Addition:** Briefly explain why your server is awesome and/or how it can benefit other Cline users. Please review our [MCP Server Approval Process](#mcp-server-approval-process) to understand our conditions for approval. +3. Confirm that you have tested giving Cline just your `README.md` and/or the `llms-install.md` and watched him successfully setup the server. This will help prevent rejection in case we have trouble setting up your server using Cline. + +That’s it! Our team will review your submission. Once approved, we’ll add your MCP server to the official Marketplace listings, and it will become discoverable by Cline users. + +### MCP Server Approval Process + +Our team maintains quality standards to ensure a secure and reliable marketplace experience. Submissions undergo a comprehensive review process that evaluates: + +- Community Adoption: We assess project traction through GitHub engagement metrics, community discussions, and overall ecosystem presence +- Developer Credibility: We verify the identity and reputation of maintainers, with preference given to established organizations and developers with verifiable professional backgrounds +- Project Maturity: We evaluate code quality, documentation completeness, maintenance activity, and long-term sustainability indicators +- Security Considerations: We apply increased scrutiny to projects in sensitive domains (such as financial services) and require additional verification for cryptocurrency-related tools + Our review team conducts regular evaluations of submissions. This thorough vetting process helps maintain the integrity of the MCP ecosystem while ensuring users have access to high-quality, trustworthy tools. + +### Making Your MCP Server One-Click Installable + +When Cline attempts to install your MCP server, he will try to use your `README.md` to guide him through the setup process. While most MCP servers include sufficient instructions in their README, you can include a `llms-install.md` file in your repository to provide additional guidance to agents like Cline. This can be particularly useful for complex setups requiring specific environment configurations or API keys. + +### Common MCP Server Submission Questions + +1. **Do I have to create a `llms-install.md` file?** + No. A well-written README with clear installation instructions is usually sufficient. Cline is quite good at understanding standard README files. The `llms-install.md` file is optional to help with complex setups or when you want to provide additional guidance. +2. **Can I submit new MCP servers without many stars?** + Absolutely! However, we do have a vetting process to ensure the security and stability of the MCP ecosystem. +3. **How long does the approval process take?** + Our team aims to review submissions within a couple of days. If your submission is approved, it will be live in the marketplace shortly thereafter.