RubyMine 2026.3 Help

MCP 服务器

从版本 2025.2 开始,RubyMine 随附集成的 MCP Server ,允许 Claude Code、Codex、VS Code 等外部客户端访问 IDE 提供的工具。 这使用户能够在不离开所选应用程序的情况下控制 JetBrains IDE 并与之交互。

启用 MCP 服务器插件

此功能依赖于 MCP 服务器插件,该插件在 RubyMine 中默认捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 Plugins。

  2. 找到 MCP Server 插件并点击 Enable。

启用 MCP Server

要启用 MCP 服务器,请执行以下操作:

  1. 转到 设置 | 工具 | MCP Server。

  2. 请选择 启用 MCP Server 复选框。

  3. 在 启用 MCP 服务器? 对话框中,查看第三方应用程序将对 IDE 中打开的项目获得哪些访问权限,然后点击 Enable 继续。

  4. 点击 Apply。

启用 MCP 服务器后,可以继续配置外部客户端。

外部客户端设置

对于检测到的外部客户端,如 Junie、 VS Code、 Claude Code、 Codex、 Air 和 GitHub Copilot CLI ,可以自动执行配置。 设置客户端意味着将 IDE MCP 服务器的地址添加到该客户端的配置文件中。

为此:

  1. 转到 设置 | 工具 | MCP Server。

  2. 在 客户端自动配置 部分中,为希望与 MCP server 一同使用的每个客户端点击 自动配置。 这会自动更新客户端的配置文件。 已配置的传输集取决于客户端。

    MCP 服务器设置

    要自行配置特定传输,请点击 (位于 自动配置 旁边),然后从列表中选择所需选项。

    配置选项
  3. 重启客户端以使配置生效。

项目级客户端设置

某些客户端还会从项目的工作目录读取配置文件。 对于这些客户端,IDE 可以将连接设置直接写入当前打开项目中的配置文件,因此 MCP 服务器仅在处理该项目时可用。

如果处理多个项目,并且不希望为每个客户端会话注册 MCP 服务器,请使用此选项。

  1. 转到 设置 | 工具 | MCP Server。

  2. 在 项目客户端自动配置 部分中,为要设置的每个客户端点击 自动配置。 这会自动更新客户端的项目级配置文件。

    自动配置客户端的项目级配置

    如果要配置特定传输机制,请点击 (位于 自动配置 旁边),然后从列表中选择所需选项。

  3. 重启客户端以使配置生效。

手动客户端设置

如果要连接的客户端不在列表中,请手动配置。

  1. 在 手动客户端配置 部分,根据连接类型点击 复制 SSE 配置、 复制 Stdio 配置 或 复制 HTTP 流配置。

    MCP 服务器手动配置
  2. 将复制的配置粘贴到客户端的设置或配置文件中。

  3. 重启客户端以使配置生效。

执行操作时无需确认

MCP server 允许已连接的外部客户端在不提示用户确认的情况下执行终端命令或运行配置。

要启用此模式:

  1. 转到 设置 | 工具 | MCP Server。

  2. 在 命令执行 部分,启用 运行 shell 命令或运行配置,无需确认(勇敢模式) 设置。

  3. 点击 Apply。

在终端会话中显示设置建议

当 Codex 或 Claude 在终端会话中启动且没有匹配的 MCP 服务器设置时,IDE 可以显示一个横幅,建议配置连接。

要控制此行为:

  1. 转到 设置 | 工具 | MCP Server。

  2. 在 终端会话 部分中,选中或清除 显示 Codex 和 Claude 终端会话的设置建议 复选框。

  3. 点击 Apply。

支持的工具

MCP 服务器公开了一组工具,允许外部客户端与 IDE 和项目交互,例如分析代码、修改文件、运行配置或执行终端命令。

可在 设置 | 工具 | MCP 服务器 | Exposed 工具 中查看和管理所有可用工具列表。 对于每个工具,选中或清除 已启用 复选框,以控制该工具是否公开给外部客户端。

Exposed Tools 设置页面

还可以为工具选中 仅路由器 复选框。 仅路由器工具会从直接 MCP 工具列表中隐藏,并且只能通过专用路由器 工具使用。 这样可让不必要的工具描述不出现在工具列表中,并节省上下文。 使用 为以下对象启用仅路由器模式 设置来指定何时应用仅路由器模式,例如用于 所有智能体 或 仅限 ACP 智能体。

下方可查阅 MCP 服务器提供的工具列表。

分析工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集分析工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集分析工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集分析工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具分析工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集工具组集分析工具

analyze_calls

为方法、函数、构造函数或受支持的类型目标构建 IDE 调用层次结构树。 使用它可查看谁调用了某个符号 (INCOMING_CALLS ),或该符号调用了什么 (OUTGOING_CALLS)。

按实际调用评估依赖项时,优先使用此工具,而不是用法搜索、文本搜索或正则表达式搜索。 它使用 IDE 调用层次结构数据,因此与原始搜索相比,可以提供更精确的调用关系,噪声更少,后续调用也更少。

将 symbolFqn 作为完全限定名称传递,例如 com.example.Service.run。 如果名称不明确,该工具会返回精确签名;请将其中一个作为 symbolFqn 传回。 如果只知道短名称或片段,请先使用 搜索符号 查找目标。

结果是一个可展开的文本树。 每个节点都包含 filePath 和 treePath ;在可能的情况下, filePath 相对于项目。 传回 treePath 以渲染子树。 使用 childOffset 在截断的 … 以及另外 n 个 行后继续。 depth、 maxChildren 和 maxNodes 会限制渲染的树。 如果 IDE 可以解析符号,则符号可能来自项目源、源 jar 或反编译的二进制 jar 依赖项。

参数:

  • symbolFqn (必需):纯完全限定符号名称,或由歧义错误返回或从渲染的子节点复制的精确签名。 如果只知道短名称或片段,请先使用 搜索符号 ,并在此处传递最佳的完全限定可调用名称。 示例: com.example.Service.run、 com.example.Service.run(String) 或 org.assertj.core.api.Assertions.assertThat(String)。 不要传递文件路径、行、列或单独的目标签名。

  • analysisKind (必需):调用分析方向。 使用 INCOMING_CALLS 显示 symbolFqn 的调用者,或使用 OUTGOING_CALLS 显示从 symbolFqn 调用的符号。

  • depth :在请求的子树根下渲染的最大调用层级数。 默认为 5。 使用 0 仅渲染子树根。

  • maxChildren :为每个节点渲染的直接子节点最大数量。 默认为 50。

  • maxNodes :渲染的调用节点总数上限。 默认为 1000。

  • treePath :指向子树根的可选路径,从之前的 analyze_calls 结果中精确复制。 Null 或省略表示根路径 []。 每个组件都是精确签名,而不是显示名称。

  • childOffset :对由 treePath 指向的节点的直接子节点进行分页时的偏移量。 默认为 0。

  • timeout :超时,单位为毫秒。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

构建项目

触发器构建项目或指定文件,等待补全,并返回构建错误。 可用此工具构建项目或编译文件,并获取详细的编译错误和警告信息。

编辑后必须使用此工具验证更改是否有效。

参数:

  • rebuild :是否对项目进行完整重建。 默认为 false。 仅当未指定 filesToRebuild 时生效。

  • filesToRebuild :如已指定,仅编译指定路径下的文件。 路径相对于项目根目录。

  • timeout :超时,单位为毫秒。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

获取文件问题

使用 IntelliJ 检查分析指定文件中的错误和警告。 使用此工具识别特定文件中的编码问题、语法错误及其他问题。

返回问题列表,包括严重程度、描述和位置信息。

参数:

  • filePath :相对于项目根目录的路径。

  • errorsOnly :是仅包含错误,还是同时包含错误和警告。

  • timeout :超时,单位为毫秒。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

获取项目依赖

返回项目中定义的所有依赖项列表。 提供有关库名称的结构化信息。

参数:

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

获取项目模块

返回项目中所有模块及其类型的列表。 提供有关每个模块的结构化信息,包括其名称和类型。

参数:

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

lint_files

使用 IntelliJ 检查分析指定文件中的错误和警告。 编辑多个文件后,使用此工具对其进行 lint 检查。 按文件返回问题,包括严重性、描述和位置信息。

当单个文件超出可用预算时,批处理响应可能包含带有 timedOut: true 且 problems 为空的文件条目。 带有 notAnalyzedReason 的文件条目表示无法分析的文件,例如位于项目内容根之外的文件、已排除的文件或不支持的文件类型。 顶层 more: true 表示批处理不完整。

参数:

  • 个文件 (必需):要分析的项目相对文件列表。 规范化后会忽略重复路径。

  • min_severity :要包含的最低严重性: 警告 或 错误。 默认为 警告。

  • timeout :超时,单位为毫秒。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

代码洞察工具

获取符号信息

检索指定文件中指定位置的符号信息。 提供与 IntelliJ IDEA 的 快速文档 功能相同的信息。 根据编程语言不同,信息可能包括符号的名称、签名、类型、文档及其他详细信息。

如果位置引用的是符号,工具将返回包含该符号声明的代码片段(如果有可用)。 使用此工具理解符号的声明、语义及位置。

参数:

  • filePath :相对于项目根目录的路径。

  • line :基于 1 的行号。

  • 列 :基于 1 的列号。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

特定数据库工具

为了确保 AI 代理严格只读访问,请使用具有适当受限(只读)权限的数据库用户,并将数据源配置为使用该用户。

cancel_sql_query

使用唯一ID取消正在运行的查询。

参数:

  • sessionId :查询会话ID。

create_database_connection

按名称、DBMS (dbms )、JDBC URL (url) 以及用于检查连接的标志 (needToCheckDs) 创建新的数据库连接(数据源)。 所有参数均为必需。 返回连接诊断信息。

参数:

  • 名称 (必需):数据库连接的唯一名称。

  • dbms :数据库管理系统 (DBMS) 的名称。

  • url :数据库连接的完整 JDBC URL,例如 jdbc:postgresql://<host>:<port>/<database>。

  • needToCheckDs :是否在创建或编辑数据源后立即测试连接。 批量配置多个连接时设置为 false — 每个连接的探测开销较大,并且可以为重要连接显式调用 test_database_connection。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

edit_database_connection

编辑由 connectionId 标识的现有数据库连接(数据源)。 更新连接的 DBMS 驱动程序和 JDBC URL;连接 名称 会保留。 返回连接诊断信息。

参数:

  • connectionId :唯一连接ID。

  • dbms :数据库管理系统 (DBMS) 的名称。

  • url :数据库连接的完整 JDBC URL,例如 jdbc:postgresql://<host>:<port>/<database>。

  • needToCheckDs :是否在创建或编辑数据源后立即测试连接。 批量配置多个连接时设置为 false — 每个连接的探测开销较大,并且可以为重要连接显式调用 test_database_connection。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

execute_sql_query

针对给定的数据库连接执行SQL查询。

工具会报告执行状态:成功或错误。 如出错,还会提供错误描述。

如果查询返回数据,将以 CSV 格式附加到工具响应中。

参数:

  • connectionId :唯一连接ID。

  • queryText :需要执行的SQL查询。

fetch_query_result

按 ID 从已执行的查询中提取行,从给定的行偏移量开始。 返回与 execute_sql_query 相同的形状: resultSetId 以及以 CSV 格式渲染的结果。

使用此工具对之前由 execute_sql_query 或 preview_table_data 返回的 resultSetId 进行分页。

参数:

  • resultSetId (必需):由之前的 execute_sql_query 或 preview_table_data 调用返回的不透明结果集 ID。

  • offset (必需):开始提取的行偏移量。 默认为 0。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

获取数据库对象描述

获取特定架构下某一数据库对象(列、类型、密钥、索引等)的层级文本结构表示。

如有歧义,将返回所有适用对象的定义。

参数:

  • connectionId :唯一连接ID。

  • databaseName :架构所属数据库名。 如果DBMS只有架构而没有数据库,则可以为空。

  • schemaName :架构名称。

  • kind :将此参数设置为特定的对象类型编码,仅列出该类型的对象。 设置为null时,会检索架构中的所有对象。

  • objectName :指定类型对象的名称(如表名或视图名)。 不得为空。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

introspect_schema

内省数据库架构,将其元数据(表、列和索引)加载到本地模型中。 当架构的 isIntrospected 标志为 false,并且需要调查架构结构或刷新过期元数据时,请使用此工具。 返回架构标识符以及更新后的内省状态。

参数:

  • connectionId :唯一连接ID。

  • databaseName :架构所属数据库名。 如果DBMS只有架构而没有数据库,则可以为空。

  • schemaName :架构名称。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

list_database_connections

检索项目中已配置的数据库连接或数据源列表。 对于每个连接,返回其唯一 ID、名称、DBMS 和驱动程序名称。

list_database_schemas

检索指定数据库连接中的数据库架构列表。

对于每个架构,工具会返回其自身名称以及数据库名称(如不适用则为空)。

参数:

  • connectionId :唯一连接ID。

  • selectedOnly :如果只应列出数据库树中选中的架构,则为true;如果应列出所有架构,则为false。

list_recent_sql_queries

此功能在免费订阅方案中不可用。

检索给定数据库连接的最近(包括当前正在运行)查询列表。

对于每条查询,返回:

  • 查询会话的唯一ID。

  • 运行查询花费的时间(单位:毫秒)。

  • 查询的当前状态。 例如,运行中、取消中、已完成等。

  • 查询的完成状态。 例如,成功、错误完成、已取消等。

  • 查询文本。

参数:

  • connectionId :唯一连接ID。

list_schema_object_kinds

检索给定数据库连接支持的架构对象类型列表。 对于每种对象类型,返回对象类型唯一代码和可读名称。

参数:

  • connectionId :唯一连接ID。

list_schema_objects

检索给定架构中的数据库对象列表。 对于每个对象,返回架构中的对象名称及类型。

参数:

  • connectionId :唯一连接ID。

  • schemaName :架构名称。

  • databaseName :架构所属数据库名。 如果DBMS只有架构而没有数据库,则可以为空。

  • kind :将此参数设置为特定的对象类型编码,仅列出该类型的对象。 设置为null时,会检索架构中的所有对象。

preview_table_data

返回指定数据库连接下表、视图、物化视图或其他类表对象的预览数据。

工具以CSV格式返回表内容。

参数:

  • connectionId :唯一连接ID。

  • schemaName :架构名称。

  • databaseName :架构所属数据库名。 如果DBMS只有架构而没有数据库,则可以为空。

  • tableName :表名。

  • maxRowCount :返回的最大行数。 默认值为 100。

test_database_connection

返回连接诊断信息:

  • 用于标识连接是否出现问题的标志:是、否或未知。

  • 关于数据库连接的详细信息,例如 DBMS 类型、版本及 JDBC 驱动。

  • 连接尝试结果摘要。 如出现失败,将包含DBMS提供的错误描述。

参数:

  • ID :唯一连接ID。

执行工具

执行特定的运行配置

运行当前项目中,指定名称的已有运行配置或由代码位置(filePath + line )临时创建的运行配置,然后等待指定超时时间完成。 可用此工具,指定通过 获取运行配置 返回的配置名称,或使用由 get_run_configurations(filePath = ...) 返回的运行点(filePath + line)。

可选启动重写(programArguments、 workingDirectory、 envs )仅对本次运行有效,不会持久保存。 除非确需更改本次运行的启动配置值,否则不要传递这些重写参数。 缺失或为 null 的重写参数会保持当前运行配置值不变。 对于字符串重写(programArguments、 workingDirectory ),缺失、null 或空字符串("" )会保留当前值。 传递如 " " 这样的仅含空格的字符串以清除本次启动的现有值。

传递 configurationName ,或结合 filePath 和 line。 这些模式互斥。

行为:

  • 当 waitForExit=true 时,最多等待 timeout 毫秒以终止进程。 若超时,进程会在后台继续运行,并且结果中会省略 exitCode。

  • 当 waitForExit=false 时,仅等待进程启动,随后立即返回,不应用 timeout。

  • fullOutputPath 指向包含完整原始输出的临时文件,同时只要进程未结束,该文件可能会继续增长。

返回执行结果,包括当前输出快照、可选退出码和可选 fullOutputPath。

参数:

  • configurationName :要执行的已有运行配置名称。

  • filePath :相对于项目根目录的文件路径。 需与 line 一同提供,以根据代码上下文创建并执行临时运行配置。

  • line :用于 filePath 的 1 起始的行号。 需与 filePath 一同提供,不可与 configurationName 组合。

  • timeout :超时,单位为毫秒。

  • waitForExit :是否等待进程终止。 若为 false,工具将在进程启动后立即返回并忽略 timeout。

  • programArguments :仅对本次启动重写可选程序实参。 缺失、null 或空字符串时保留当前值,仅含空格的字符串将清空此值。

  • workingDirectory :本次启动可选工作目录重写。 缺失、null 或空字符串时保留当前值,仅含空格的字符串将清空此值。

  • envs :本次启动可选环境变量重写。 缺失/为 null 时,保持现有环境不变;如有设置,则值将覆盖现有环境。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

获取运行配置

根据输入,返回项目运行配置或可执行文件代码位置。

无 filePath 时,此工具会列出项目现有运行配置。 结果包含配置名称,以及如有可用时,启动详情,如程序实参、工作目录、环境变量和 supportsDynamicLaunchOverrides。

supportsDynamicLaunchOverrides 是 执行运行配置 和 xdebug_start_debugger_session(启动调试器会话) 中一次性启动重写(programArguments、 workingDirectory、 envs )的权威能力标志。 仅当所选配置的此标志为 真 时传递这些重写参数。

有 filePath 时,此工具会发现该文件中的可执行文件入口点(运行点),如测试方法、主方法或 IDE 显示运行装订区域图标的其他可执行文件入口点。 结果包含 filePath 和 runPoints ,可配合 执行运行配置 返回的行号进行代码运行。

参数:

  • filePath :可选的相对于项目根目录的文件路径。 如有提供,则返回该文件中的运行点(可执行文件入口点),而不是项目范围的运行配置。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

文件工具

创建新文件

在项目目录中指定路径下创建一个新文件。 可选地将提供的文本写入文件中。

参数:

  • pathInProject :要创建文件的路径,相对于项目根目录。

  • 文本 (可选):要写入新文件的内容。

  • overwrite :是否覆盖已有文件。 如果设置为 false ,则在发生冲突时抛出异常。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

获取所有打开的文件路径

返回当前活动编辑器或其他打开的编辑器中打开进行编辑的所有文件的路径,相对于项目根目录。 使用此工具查看当前打开的编辑器。

参数:

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

列出目录树

以伪图形格式提供指定目录的树形表示,类似于 树 工具。 使用此工具查看目录或整个项目的内容。 建议使用此工具而非如 ls 或 dir 等命令行工具进行目录列表。

参数:

  • directoryPath :相对于项目根目录的路径。

  • maxDepth :最大递归深度。

  • timeout :超时,单位为毫秒。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

在编辑器中打开文件

在 JetBrains IDE 编辑器中打开指定文件。 需要一个包含要打开的文件路径的 filePath 参数。 文件路径可以是绝对路径,也可以是相对于项目根目录的路径。

参数:

  • filePath :相对于项目根目录的路径。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

格式设置工具

重新格式化文件

在 JetBrains IDE 中重新格式化指定文件。 使用此工具为通过路径确定的文件应用代码格式化。

参数:

  • 路径 :相对于项目根目录的路径。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

检查生成器 MCP 工具

验证检查 kts

根据规范示例验证 检查.kts 脚本。 编译检查并对正例/负例进行运行。 返回编译状态和详细验证结果。

正例应触发检查(预期存在问题)。 负例不应触发检查(禁止行应无问题)。

返回整体成功、单例结果及聚合统计。

参数:

  • inspectionKtsCode :需要编译和验证的 检查.kts 脚本内容。

  • pathToSpecification :带有要验证示例的规范路径。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

检查 KTS MCP 工具

生成检查 kts api

返回目标语言的检查 KTS API 文档。 提供可用于编写 检查.kts 文件的类及函数。

参数:

  • language :目标语言:'Java' 或 'Kotlin'。

  • wrapInTags :如为 true,则将 API 内容包裹在 <API> 和 <api.kt> 标记中。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

生成检查 kts 示例

返回目标语言的示例 检查.kts 模板,用于指导代码生成。 提供已包装 XML 的示例,展示如何使用 InspectionKts API 编写检查。

参数:

  • language :目标语言:'Java' 或 'Kotlin'。

  • includeAdditionalExamples :如为 true,还包括除模板外的额外精选示例。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

生成 psi 树

为提供的 Java 或 Kotlin 代码创建 PSI 树,并以缩进文本形式返回。 可用此工具理解编写检查时代码段的 PSI 结构。 输出显示元素类型及其层次结构,并对何时需要 node.children() 给出提示。

参数:

  • code :要解析的源代码段。

  • language :目标语言:'Java' 或 'Kotlin'。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

运行检查 kts

编译 检查.kts 脚本并在目标文件上运行。 如有编译错误则返回,否则返回检查发现的问题列表。 请使用此工具在开发过程中测试 检查.kts 脚本。

参数:

  • inspectionKtsCode :要编译和运行的 检查.kts 脚本内容。

  • contextPath :项目中需分析的目标文件的相对路径(例如, src/my/软件包/Example.kt )。

  • targetFileContent :要分析的目标文件内容。 如果未提供,文件必须存在于项目中。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

补丁工具

apply_patch

应用 Codex apply_patch 格式或统一 Git diff 格式的补丁。 支持 Add、Delete 和 Update 操作,并为更新提供可选的移至路径。 路径必须位于项目目录内。

参数:

  • 输入: apply_patch 格式或统一 Git diff 格式的补丁文本。

  • patch: 输入 的别名,用于兼容发送 {patch: ...} 的客户端。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

读取工具

读取文件

读取项目目录中的文件,或来自任何项目依赖项或其他项目源根的文件。 可读取 Jar/Jrt 文件中的源代码,也可反编译 Jar/Jrt 文件内或磁盘上的 Java 类文件。 返回带编号(从 1 开始)的文本行。

模式:

  • slice

  • lines

  • line_columns

  • offsets

  • indentation

模式详情:

  • slice 使用 start_line 和 max_lines。

  • lines 使用 start_line/end_line (包含端点)。

  • line_columns 使用 start_line/start_column 和 end_line/end_column (结束 不包含在内; end_line 默认为 start_line)。

  • offsets 使用 start_offset/end_offset (结束 不包含在内)。

  • indentation 与 start_line 配合 max_levels/include_* 使用。

max_lines 限制所有模式下的总输出量; context_lines 应用于区间模式(每侧)。

参数:

  • file_path :文件路径。 支持项目相对路径、包含 '..' 的路径、绝对路径、类似 /路径/lib.jar!/pkg/Foo .class 的归档条目,以及如 文件:// 、 jar:// 和 jrt:// 的 URL。 任何其他工具返回的路径均可直接传递(例如来自 search_* 工具的路径)。

  • mode :读取模式: slice、 lines、 line_columns、 offsets 或 indentation。

  • start_line :从第 1 行开始读取的行号。

  • max_lines :返回的最大行数(切片用作行计数;所有模式都会限制输出)。

  • end_line: lines/line_columns 模式的 1 起始结束行(lines 为包含端点; line_columns 为不包含端点)。

  • start_column: line_columns 模式下,第 1 列起始列。

  • end_column :区间读取的第 1 结束列(不包含端点)。

  • start_offset :偏移模式下的 0 起始偏移量(需要 end_offset)。

  • end_offset :偏移模式下的 0 结束偏移量(不包含端点)。

  • context_lines :要在范围周围每侧包含的上下文行数。

  • max_levels :缩进模式:包含的最大缩进层级数(0 = 仅锚点块)。

  • include_siblings :缩进模式:包含同一缩进级别的同级块。

  • include_header :缩进模式:包含位于锚点正上方的页眉注释/注解。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

重构工具

重命名重构

重命名指定文件中的符号(变量、函数、类等)。 使用此工具执行重命名重构操作。

与简单的文本查找替换不同, 重命名重构 工具是具备上下文感知能力的实用工具,能够理解代码结构。 它会智能地更新项目中所有对指定符号的引用,确保代码完整性并防止引用断裂。 此方法始终是程序符号重命名的优选方案。

如果重命名操作成功,工具将返回成功消息;如果文件或符号无法找到,或重命名失败,将返回错误消息。

参数:

  • pathInProject :相对于项目根目录的路径。

  • symbolName :要重命名的符号名称。

  • newName :符号的新名称。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

搜索工具

搜索文件

通过 glob 模式在项目内搜索文件。 当需要使用 glob 语法匹配文件路径时,请使用此工具。

Glob 模式是相对于项目根目录的。

示例:

  • "**/*.kt"

  • "src/**/Foo*.java"

  • "build.gradle.kts"

没有 '/' 的模式将视为 "**/pattern"。 paths 为相对于项目根目录的可选附加 glob 筛选器。

参数:

  • q :要搜索的 glob 模式。

  • paths :用于筛选结果的可选项目相对 glob 模式列表。 支持 ! 排除项。 结尾处的 / 会扩展为 **。 没有 / 的模式将视为 **/pattern。 空字符串将被忽略。

  • includeExcluded :是否在结果中包含已排除/已忽略文件。

  • limit :返回的最大结果数。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

搜索正则表达式

在项目文件内搜索正则表达式匹配。 需要代码段结果的正则表达式搜索时请使用此工具。 结果在可用时会包含匹配坐标(1 起始行/列,0 起始偏移量)。

路径为相对于项目根目录的 glob 模式。

示例:

  • ["src/**", "!**/test/**"]

  • ["**/*.kt"]

  • ["foo/"]

参数:

  • q :要搜索的正则表达式模式。

  • paths :用于筛选结果的可选项目相对 glob 模式列表。 支持 ! 排除项。 结尾处的 / 会扩展为 **。 没有 / 的模式将视为 **/pattern。 空字符串将被忽略。

  • limit :返回的最大结果数。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

搜索符号

搜索符号(类、方法、字段)。 用于通过标识符片段进行语义查找时请使用此工具。 结果在可用时会包含匹配坐标(1 起始行/列,0 起始偏移量)。

路径为相对于项目根目录的 glob 模式。

默认仅搜索项目符号。 如果未找到合适结果,请用 include_external=true 再试一次以便同时搜索 SDK 和库符号。

参数:

  • q :符号查询文本。

  • paths :用于筛选结果的可选项目相对 glob 模式列表。 支持 ! 排除项。 结尾处的 / 会扩展为 **。 没有 / 的模式将视为 **/pattern。 空字符串将被忽略。

  • include_external :是否包含 SDK 和库符号。 默认禁用;如未找到合适项,请用 include_external=true 再试一次。

  • limit :返回的最大结果数。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

搜索文本

在项目文件中搜索文本子字符串。 需要代码段结果的快速文本搜索时请使用此工具。 结果在可用时会包含匹配坐标(1 起始行/列,0 起始偏移量)。

路径为相对于项目根目录的 glob 模式。

示例:

  • ["src/**", "!**/test/**"]

  • ["**/*.kt"]

  • ["foo/"]

参数:

  • q :要搜索的文本。

  • paths :用于筛选结果的可选项目相对 glob 模式列表。 支持 ! 排除项。 结尾处的 / 会扩展为 **。 没有 / 的模式将视为 **/pattern。 空字符串将被忽略。

  • limit :返回的最大结果数。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

技能搜索工具

使用显式模式执行统一项目搜索:

  • file :glob 路径搜索。

  • 文本 :字面内容搜索。

  • regex :正则表达式内容搜索。

  • symbol :语义符号查找。

默认情况下,符号搜索以项目为重点。 如果未找到合适的符号,请使用 include_external=true 重试,以同时搜索 SDK 和库符号。

参数:

  • mode (必需):搜索模式: file、 文本、 regex 或 symbol。

  • q (必需):搜索查询。 对于 mode=file ,这是 glob 模式。

  • paths :可选的项目相对 glob 筛选器。 支持 !-excludes 和末尾的 /。

  • include_external :是否为 mode=symbol 包含 SDK 和库符号。 默认禁用;如果未找到合适的内容,请使用 include_external=true 重试。

  • includeExcluded :是否包含已排除或已忽略的文件。 仅支持 mode=file。

  • limit :返回的最大结果数。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

终端工具

执行终端命令

在 IDE 内置终端中执行指定的 shell 命令。 使用此工具在 IDE 环境中运行终端命令。

重要功能及限制:

  • 在收集输出之前检查进程是否正在运行。

  • 输出限制为最多 2000 行(多余部分将被截断)。

  • 在达到指定超时时间后终止,并显示通知。

  • 除非在设置中启用 Brave Mode ,否则需要用户确认。

返回可能的响应:

  • 终端输出(若超过 2000 行则被截断)。

  • 如果命令超时,将返回包含中断提示的输出。

  • 各种失败情况下的错误信息。

参数:

  • 命令 :要执行的 shell 命令。

  • executeInShell :是否在用户的默认 shell(如 bash、zsh 等)中执行命令。 如果命令是 shell 脚本,或需要保留用户终端的真实环境,则此选项很有用。 如果设置为 false ,则命令将作为进程启动。

  • reuseExistingTerminalWindow :是否复用现有的终端窗口以避免创建多个终端。

  • timeout :超时,单位为毫秒。

  • maxLinesCount :要返回的最大行数。

  • truncateMode :文本截断方式:从开头、中间、结尾截断,或不截断。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

通用工具

execute_tool

通用工具执行器,可从命令行字符串动态调用特定的 IDE MCP 工具。

参数:

  • 命令 (必需):包含工具名称和实参的命令行字符串。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

VCS 工具

获取仓库

检索项目中的 VCS 根目录列表。 使用此工具识别多仓库项目中的所有版本库。

参数:

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

git_status

检索当前项目中一个或多个仓库的 Git 状态。 返回 porcelain 风格的索引和工作树状态代码及汇总计数器。 默认情况下,会返回所有 Git 仓库。

参数:

  • repositoryPathRelativeToProject :相对于项目根目录的可选路径,用于选择单个包含该路径的仓库。

  • includeUntracked :是否包含未跟踪的文件。

  • includeIgnored :是否包含已忽略的文件。

  • limit :每个仓库返回的最大条目数。

  • projectPath :项目路径。 如果已知该值,请务必提供,以减少调用的歧义性。 如果只知道当前工作目录,可以将其用作项目路径。

Rails 专用工具

get_rails_routes

检索项目中的 Rails 路由。 结果以分页列表返回,并可根据包含/排除的路径、操作(由完全限定名称或 FQN 指定)、目录和 HTTP 方法进行筛选。

建议使用此工具而非手动代码检查,因为它可对 Rails 路由执行深度分析。

参数:

  • 页面 :用于分页的页码。

  • page_size :每页显示的项数。

  • included_route_path_filters :要包含的路由路径模式列表。

  • excluded_route_path_filters :要排除的路由路径模式列表。

  • included_action_fqn_filters :要包含的完整限定操作名称列表。

  • excluded_action_fqn_filters :要排除的完整限定操作名称列表。

  • included_action_directory_filters :要包含的操作目录列表。

  • excluded_action_directory_filters :要排除的操作目录列表。

  • min_action_count :每条路由必须包含的最少操作数。

  • max_action_count :每条路由最多包含的操作数。

  • included_http_method_filters :要包含的 HTTP 方法列表(GET、POST 等)。

  • excluded_http_method_filters :要排除的 HTTP 方法列表。

get_rails_models

检索项目中的 Rails model。 结果为分页显示,可按 FQN 进行筛选

参数:

  • 页面 :用于分页的页码。

  • page_size :每页显示的项数。

  • included_fqn_filters :要包含的 FQN 模式列表。

  • excluded_fqn_filters :要排除的 FQN 模式列表。

  • included_directory_filters :要包含的目录列表。

  • excluded_directory_filters :要排除的目录列表。

  • controller_filter :仅包含具有或不具有对应控制器的 model 的筛选器。

get_rails_controllers

检索项目中的 Rails 控制器。 结果按页分页,可按 FQN、目录、视图、抽象状态以及是否存在对应 model 进行筛选。

参数:

  • 页面 :用于分页的页码。

  • page_size :每页显示的项数。

  • included_fqn_filters :要包含的 FQN 模式列表。

  • excluded_fqn_filters :要排除的 FQN 模式列表。

  • included_directory_filters :要包含的目录列表。

  • excluded_directory_filters :要排除的目录列表。

  • included_view_filters :要包含的视图筛选器列表。

  • excluded_view_filters :要排除的视图筛选器列表。

  • abstract_filter :仅包含抽象、非抽象或全部控制器的筛选器。

  • model_filter :仅包含具有或不具有对应 model 的控制器的筛选器。

get_rails_helpers

检索项目中的 Rails 帮助程序。 结果按页分页,可按 FQN 和目录进行筛选。

参数:

  • 页面 :用于分页的页码。

  • page_size :每页显示的项数。

  • included_fqn_filters :要包含的 FQN 模式列表。

  • excluded_fqn_filters :要排除的 FQN 模式列表。

  • included_directory_filters :要包含的目录列表。

  • excluded_directory_filters :要排除的目录列表。

get_rails_views

检索项目中的 Rails 视图。 结果按页分页,可按部分性、布局、控制器关联、路径和控制器目录/FQN 进行筛选。

参数:

  • 页面 :用于分页的页码。

  • page_size :每页显示的项数。

  • partiality_filter :筛选器,仅包含部分视图、非部分视图或全部视图。

  • layout_filter :筛选器,仅包含布局视图、非布局视图或全部视图。

  • controller_filter :筛选器,仅包含具有相关控制器的视图。

  • included_path_filters :要包含的视图路径列表。

  • excluded_path_filters :要排除的视图路径列表。

  • included_controller_fqn_filters :要包含的控制器 FQN 列表。

  • excluded_controller_fqn_filters :要排除的控制器 FQN 列表。

  • included_controller_directory_filters :要包含的控制器目录列表。

  • excluded_controller_directory_filters :要排除的控制器目录列表。

get_rails_mailers

检索项目中的 Rails 邮件程序。 结果按页分页,可按 FQN 和目录进行筛选。

参数:

  • 页面 :用于分页的页码。

  • page_size :每页显示的项数。

  • included_fqn_filters :要包含的 FQN 模式列表。

  • excluded_fqn_filters :要排除的 FQN 模式列表。

  • included_directory_filters :要包含的目录列表。

  • excluded_directory_filters :要排除的目录列表。

2026年 11月 9日