diff --git a/docs/features/mcp/overview.md b/docs/features/mcp/overview.md index 2f38b5ee..7a9af8c2 100644 --- a/docs/features/mcp/overview.md +++ b/docs/features/mcp/overview.md @@ -18,3 +18,5 @@ This documentation is organized into several sections: * [**STDIO & SSE Transports**](/features/mcp/server-transports) - Detailed comparison of local (STDIO) and remote (SSE) transport mechanisms with deployment considerations for each approach. * [**MCP vs API**](/features/mcp/mcp-vs-api) - Analysis of the fundamental distinction between MCP and REST APIs, explaining how they operate at different layers of abstraction for AI systems. + +* [**Recommended MCP Servers**](/features/mcp/recommended-mcp-servers) - Curated list of tested and recommended MCP servers for Roo Code, including a setup guide for Context7. diff --git a/docs/features/mcp/recommended-mcp-servers.md b/docs/features/mcp/recommended-mcp-servers.md new file mode 100644 index 00000000..b8d5da3d --- /dev/null +++ b/docs/features/mcp/recommended-mcp-servers.md @@ -0,0 +1,123 @@ +--- +title: Recommended MCP Servers +sidebar_label: Recommended MCP Servers +--- + +# Recommended MCP Servers + +While Roo Code can connect to any Model Context Protocol (MCP) server that follows the specification, the community has already built several high-quality servers that work out-of-the-box. This page curates the servers we **actively recommend** and provides step-by-step setup instructions so you can get productive in minutes. + +> We'll keep this list up-to-date. If you maintain a server you'd like us to consider, please open a pull-request. + +--- + +## Context7 + +`Context7` is our first-choice general-purpose MCP server. It ships a collection of highly-requested tools, installs with a single command, and has excellent support across every major editor that speaks MCP. + +### Why we recommend Context7 + +* **One-command install** – everything is bundled, no local build step. +* **Cross-platform** – runs on macOS, Windows, Linux, or inside Docker. +* **Actively maintained** – frequent updates from the Upstash team. +* **Rich toolset** – database access, web-search, text utilities, and more. +* **Open source** – released under the MIT licence. + +--- + +## Installing Context7 in Roo Code + +There are two common ways to register the server: + +1. **Global configuration** – available in every workspace. +2. **Project-level configuration** – checked into version control alongside your code. + +We'll cover both below. + +### 1. Global configuration + +1. Open the Roo Code **MCP settings** panel by clicking the icon. +2. Click **Edit Global MCP**. +3. Paste the JSON below inside the `mcpServers` object and save. + +```json +{ + "mcpServers": { + "context7": { + "command": "npx", + "args": ["-y", "@upstash/context7-mcp@latest"] + } + } +} +``` + +**Windows (cmd.exe) variant** + +```json +{ + "mcpServers": { + "context7": { + "type": "stdio", + "command": "cmd", + "args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"] + } + } +} +``` + +Also on **Windows (cmd)** you may need to invoke `npx` through `cmd.exe`: + +Adding Context7 to the global MCP settings + +### 2. Project-level configuration + +If you prefer to commit the configuration to your repository, create a file called `.roo/mcp.json` at the project root and add the same snippet: + +```json +{ + "mcpServers": { + "context7": { + "command": "npx", + "args": ["-y", "@upstash/context7-mcp@latest"] + } + } +} +``` + +**Windows (cmd.exe) variant** + +```json +{ + "mcpServers": { + "context7": { + "type": "stdio", + "command": "cmd", + "args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"] + } + } +} +``` + +Adding Context7 to a project-level MCP file + +> When both global and project files define a server with the same name, **the project configuration wins**. + +--- + +## Verifying the installation + +1. Make sure **Enable MCP Servers** is turned on in the MCP settings panel. +2. You should now see **Context7** listed. Click the toggle to start it if it isn't already running. +3. Roo Code will prompt you the first time a Context7 tool is invoked. Approve the request to continue. + +Context7 running in Roo Code + +--- + +## Next steps + +* Browse the list of tools shipped with Context7 in the server pane. +* Configure **Always allow** for the tools you use most to streamline your workflow. +* Want to expose your own APIs? Check out the [MCP server creation guide](/features/mcp/using-mcp-in-roo#enabling-or-disabling-mcp-server-creation). + +Looking for other servers? Watch this page – we'll add more recommendations soon! \ No newline at end of file diff --git a/sidebars.ts b/sidebars.ts index c17d2a38..1907251b 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -51,6 +51,7 @@ const sidebars: SidebarsConfig = { 'features/mcp/what-is-mcp', 'features/mcp/server-transports', 'features/mcp/mcp-vs-api', + 'features/mcp/recommended-mcp-servers', ], }, { diff --git a/static/img/recommended-mcp-servers/context7-global-setup.png b/static/img/recommended-mcp-servers/context7-global-setup.png new file mode 100644 index 00000000..785d17ca Binary files /dev/null and b/static/img/recommended-mcp-servers/context7-global-setup.png differ diff --git a/static/img/recommended-mcp-servers/context7-project-setup.PNG b/static/img/recommended-mcp-servers/context7-project-setup.PNG new file mode 100644 index 00000000..bb8b6023 Binary files /dev/null and b/static/img/recommended-mcp-servers/context7-project-setup.PNG differ diff --git a/static/img/recommended-mcp-servers/context7-running.PNG b/static/img/recommended-mcp-servers/context7-running.PNG new file mode 100644 index 00000000..1e80a0f0 Binary files /dev/null and b/static/img/recommended-mcp-servers/context7-running.PNG differ