Lzh on GitHub

Roo Code Marketplace

探索和安装来自 Roo Code Marketplace 的社区贡献的 MCP 服务器和自定义模式，以扩展你的 AI 编码助手的能力。

概述

Roo Code Marketplace 是一个中心枢纽，用于发现和安装社区贡献的扩展，即 MCP（模型上下文协议）和模式。它使你能够轻松扩展 Roo Code 的功能，以适应你的特定需求和工作流程。

主要功能

  • 可发现性： 浏览精选的 MCP 和模式列表。
  • 简单安装： 一键安装和移除项目。
  • 社区驱动： 访问来自 Roo Code 社区的不断增长的扩展集合。
  • 项目和全局范围： 为特定项目或所有项目安装项目。

入门

Roo Code Marketplace 直接在 VS Code 的 Roo Code 扩展中可用。通过点击顶部菜单栏中的 marketplace 图标 🛍️ 访问它。

Marketplace 项目

Marketplace 提供两种类型的项目：

MCPs (Model Context Protocol)

MCP 允许 Roo Code 连接并与各种 AI 模型、API 和其他外部工具进行交互。通过安装 MCP，你可以配置 Roo Code 来使用不同的语言模型（如来自 OpenAI、Anthropic 或其他模型的）或集成其他服务。了解更多关于 什么是 MCP？以及 如何在 Roo Code 中使用 MCP。

模式

模式是自定义的指令和规则集，用于为特定任务定制 Roo Code 的行为。例如，你可能会找到一个“React 组件”模式，它专为创建 React 组件而优化，或一个“文档编写器”模式，用于编写技术文档。了解更多关于 使用模式 和 创建自定义模式。

安装范围

当你从 marketplace 安装一个项目时，你可以选择在项目级别或全局级别安装它。

项目安装

  • 范围： 该项目仅在当前 VS Code 工作区（你的项目）中可用。
  • 配置文件：
    • MCPs：你项目根目录中的 .roo/mcp.json。
    • 模式：你项目根目录中的 .roomodes。
  • 用例： 当一个项目特定于某个项目的需求或你想与你的团队共享一个项目特定的配置时，这很有用。

全局安装

  • 范围： 该项目在你所有 VS Code 工作区中都可用。
  • 配置文件：
    • MCPs：Roo Code 扩展的全局设置目录中的 mcp_settings.json。
    • 模式：Roo Code 扩展的全局设置目录中的 custom_modes.yaml。
  • 用例： 这对于你想在所有项目中使用的项目来说是理想的，例如一个最喜欢的模式或一个常用的 MCP。

使用 Marketplace

浏览和筛选

你可以在 marketplace 视图中浏览所有可用的项目。要查找特定项目：

  • 搜索： 使用搜索栏按名称或描述查找项目。
  • 按类型筛选： 仅显示 MCP 或仅显示模式。
  • 按标签筛选： 查找与特定技术或任务相关的项目。
  • 仅显示已安装： 使用“已安装”复选框将视图筛选为仅显示你已安装的项目，从而更容易管理和审查你已安装的扩展。

“仅显示已安装” 筛选器在以下情况下特别有用：

  • 你想快速查看你已安装了哪些 MCP 或模式。
  • 你需要管理或移除已安装的项目。
  • 你正在审查你的项目或全局配置。

安装项目

  1. 找到你想安装的项目。
  2. 点击 “安装” 按钮。
  3. 选择是为当前 项目 还是 全局 安装它。

安装 MCPs

对于 MCPs，你可能还需要：

  • 选择安装方法（NPX 或 Docker）。
  • 在提示时提供额外的参数（参见 参数化 MCPs）。

安装模式

对于模式，只需选择安装范围并点击“安装”。

  1. Roo Code 会自动将该项目添加到相应的配置文件中。如果文件不存在，Roo Code 会为你创建它。然后该文件会打开供你审查。

移除项目

  1. 在 marketplace 视图中找到已安装的项目（已安装的项目会显示“移除”按钮）。
  2. 点击“移除”按钮。
  3. 如果该项目在两个范围内都已安装，则选择从当前项目移除或全局移除。
  4. Roo Code 将该项目从相应的配置文件中移除。

注意： “移除”按钮是上下文感知的。如果一个项目只在一个范围内安装（例如，只为项目），它将是一个单一操作按钮。只有当该项目在两个范围内都已安装时，才会出现带有“从项目移除”和“全局移除”选项的下拉菜单。

重要： 点击按钮或从下拉菜单中选择一个选项后，移除是即时的。没有额外的确认提示。

参数化 MCPs

一些 MCP 在安装期间需要特定信息，例如 API 密钥或 URL。当安装这些“参数化”MCP 时，你将被提示：

  • 审查任何先决条件（如创建账户或获取 API 密钥）。
  • 输入所需的配置值。
  • 如果适用，选择安装方法。

这可以确保敏感信息的安全，并使配置更灵活。

故障排除

安装错误

  • 无效的 YAML/JSON： 配置文件（.roomodes、.roo/mcp.json 等）有语法错误。为了防止数据丢失，Roo Code 不会修改已损坏的配置文件。请在安装或移除项目之前修复语法错误。
  • 文件未找到： 罕见错误 - Roo Code 会自动创建必要的配置文件。

项目不工作

如果已安装的项目不工作：

  1. 检查配置文件： 验证项目是否已正确添加。
  2. 重启 VS Code： 新的配置有时需要重启。
  3. 检查先决条件： 审查项目的描述以了解任何要求。
  4. 检查 Roo Code 日志： 在 Roo Code 输出面板中查找错误消息。

相关文档

针对 MCPs

针对模式