MCP 服务器
从 2025.2 版本开始,WebStorm 集成了 MCP Server ,允许 Claude Code、Codex、VS Code 等外部客户端访问 IDE 提供的工具。 这让用户无需离开所选择的应用程序,即可控制 JetBrains IDE 并与其交互。
启用 MCP 服务器插件
此功能依赖于 MCP 服务器插件,该插件默认在 WebStorm 中捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。
按下 Ctrl+Alt+S 打开设置,然后选择 。
找到 MCP Server 插件,然后点击 启用。
启用 MCP 服务器
要启用 MCP 服务器,请执行以下操作:
转到 。
请选择 启用 MCP 服务器 复选框。
在 启用 MCP 服务器? 对话框中,查看第三方应用程序将对 IDE 中打开的项目获得哪些访问权限,然后点击 启用 继续。
点击 Apply。
启用 MCP 服务器后,可以继续配置外部客户端。
外部客户端设置
对于检测到的外部客户端,例如 Junie、 VS Code、 Claude Code、 Codex、 Air 和 GitHub Copilot CLI ,可以自动执行配置。 设置客户端意味着将 IDE MCP 服务器的地址添加到该客户端的配置文件中。
为此:
转到 。
在 客户端自动配置 部分,为每个要与 MCP 服务器一起使用的客户端点击 自动配置。 这会自动更新客户端的配置文件。 已配置的传输方式集合取决于客户端。

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

重启客户端以使配置生效。
项目级客户端设置
某些客户端还会从项目的工作目录读取配置文件。 对于这些客户端,IDE 可以将连接设置直接写入当前打开项目中的配置文件,因此 MCP 服务器仅在处理该项目时可用。
如果处理多个项目,并且不希望为每个客户端会话注册 MCP 服务器,请使用此选项。
转到 。
在 项目客户端自动配置 部分,为要设置的每个客户端点击 自动配置。 这会自动更新客户端的项目级配置文件。

如果要配置特定的传输机制,请点击
,位置在 自动配置 旁边,然后从列表中选择所需选项。
重启客户端以使配置生效。
手动客户端设置
如果要连接的客户端不在列表中,请手动配置。
在 手动客户端配置 部分,根据连接类型点击 复制 SSE 配置、 复制 Stdio 配置 或 复制 HTTP 流配置。

将复制的配置粘贴到您的客户端的设置或配置文件中。
重启客户端以使配置生效。
无需确认执行操作
MCP 服务器允许已连接的外部客户端在 IDE 中执行终端命令或运行配置,而无需每次都提示用户确认。
要启用此模式:
转到 。
在 命令执行 部分,启用 无需确认即可运行 shell 命令或运行配置(Brave 模式) 设置。
点击 Apply。
在终端会话中显示设置建议
当 Codex 或 Claude 在终端会话中启动且没有匹配的 MCP 服务器设置时,IDE 可以显示一个横幅,建议配置连接。
要控制此行为:
转到 。
在 终端会话 部分,选中或清除 显示 Codex 和 Claude 终端会话的设置建议 复选框。
点击 Apply。
支持的工具
MCP 服务器提供了一组工具,允许外部客户端与 IDE 及项目交互,例如分析代码、修改文件、运行配置或执行终端命令。
您可以在 查看和管理所有可用工具列表。 对于每个工具,选中或清除 已启用 复选框,以控制是否将该工具暴露给外部客户端。

还可以为工具选中 仅路由器 复选框。 仅路由器工具会从直接 MCP 工具列表中隐藏,并且只能通过专用路由器 工具 使用。 这样可以避免工具列表中出现不必要的工具描述,并节省上下文。 使用 为以下对象启用仅路由器模式 设置来指定何时应用仅路由器模式,例如用于 所有智能体 或 仅限 ACP 智能体。
下方可查看 MCP 服务器提供的工具列表。
分析工具
- analyze_calls
为方法、函数、构造函数或受支持的类型目标构建 IDE 调用层次结构树。 使用它查看谁调用了符号(
INCOMING_CALLS)或该符号调用了什么(OUTGOING_CALLS)。在按实际调用评估依赖项时,优先使用此工具,而不是用法搜索、文本搜索或正则表达式搜索。 它使用 IDE 调用层次结构数据,因此与基础搜索相比,能提供更精确的调用关系,噪音更少,后续调用也更少。
将
symbolFqn作为完全限定名称传递,例如com.example.Service.run。 如果名称不明确,该工具会返回精确签名;请将其中一个签名作为symbolFqn传回。 如果只知道短名称或片段,请先使用search_symbol查找目标。结果是可展开的文本树。 每个节点都包含
filePath和treePath;如果可能,filePath相对于项目。 传回treePath以渲染子树。 使用childOffset在截断的 后继续…… 及另外 n 个 行之后继续。depth、maxChildren和maxNodes会限制渲染的树。 当 IDE 能够解析符号时,符号可以来自项目源、源 jar 或反编译的二进制 jar 依赖项。参数:
symbolFqn(必需):普通的完全限定符号名称,或由歧义错误返回或从渲染的子节点复制的精确签名。 如果只知道短名称或片段,请先使用search_symbol,然后在此处传递最佳的完全限定可调用名称。 示例: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:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- build_project
触发构建项目或指定文件、等待完成,并返回构建错误。 使用此工具构建项目或编译文件,并获取有关编译错误和警告的详细信息。
进行编辑后,需要使用此工具以验证编辑的有效性。
参数:
rebuild:是否对项目进行完全重建。 默认为 false。 仅在未指定filesToRebuild时生效。filesToRebuild:若指定,仅编译具有指定路径的文件。 路径为相对于项目根目录。timeout:超时(毫秒)。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- get_file_problems
使用 IntelliJ 检查分析指定文件中的错误和警告。 使用此工具识别特定文件中的代码问题、语法错误及其他问题。
返回问题列表,包括严重性、描述和位置信息。
参数:
filePath:相对于项目根目录的路径。errorsOnly:是否仅包含错误,或同时包含错误和警告。timeout:超时(毫秒)。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- get_project_dependencies
返回项目中定义的所有依赖项列表。 提供有关库名称的结构化信息。
参数:
projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- get_project_modules
返回项目中所有模块及其类型的列表。 提供每个模块的结构化信息,包括其名称和类型。
参数:
projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- lint_files
使用 IntelliJ 检查分析指定文件中的错误和警告。 编辑多个文件后,使用此工具对它们进行 lint 检查。 返回每个文件的问题,包括严重性、描述和位置信息。
当单个文件超出可用预算时,批量响应可能包含带有
timedOut: true且problems为空的文件条目。 带有notAnalyzedReason的文件条目表示无法分析的文件,例如项目内容根之外的文件、已排除的文件或不支持的文件类型。 顶级more: true表示批处理不完整。参数:
文件(必需):要分析的项目相对文件列表。 规范化后会忽略重复路径。min_severity:要包含的最低严重性:warning或error。 默认值为warning。timeout:超时(毫秒)。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
代码洞察工具
- get_symbol_info
检索指定文件中指定位置的符号信息。 提供与 IntelliJ IDEA 的 快速文档 功能相同的信息。 这些信息可能包括符号的名称、签名、类型、文档及其他详细信息,具体取决于编程语言。
如果该位置引用了某个符号,且声明可用,该工具将返回包含该符号声明的代码片段。 使用此工具了解符号的声明、语义及位置。
参数:
filePath:相对于项目根目录的路径。line:从 1 开始的行号。column:从 1 开始的列号。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
特定数据库工具
要保证 AI Agent 严格只读访问,请使用具有适当限制(只读)权限的数据库用户,并将数据源配置为使用该用户。
- cancel_sql_query
使用唯一 ID 取消正在运行的查询。
参数:
sessionId:查询会话 ID。
- 创建数据库连接
按名称、DBMS(
dbms)、JDBC URL(url)以及用于检查连接的标志(needToCheckDs)创建新的数据库连接(数据源)。 所有参数均为必需。 返回连接诊断信息。参数:
name(必需):数据库连接的唯一名称。dbms:数据库管理系统(DBMS)的名称。url:数据库连接的完整 JDBC URL,例如jdbc:postgresql://<host>:<port>/<database>。needToCheckDs:是否在创建或编辑数据源后立即测试连接。 批量配置多个连接时设置为false— 每个连接的探测成本较高,并且可以针对重要连接显式调用test_database_connection。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- 编辑数据库连接
编辑由
connectionId标识的现有数据库连接(数据源)。 更新连接的 DBMS 驱动程序和 JDBC URL;连接name会保留。 返回连接诊断信息。参数:
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 查询。
- 获取查询结果
按 ID 从已执行的查询中提取行,从给定的行偏移量开始。 返回与
execute_sql_query相同的形状:resultSetId以及 CSV 格式的渲染结果。使用此工具对之前由
execute_sql_query或preview_table_data返回的resultSetId进行分页。参数:
resultSetId(必需):先前execute_sql_query或preview_table_data调用返回的不透明结果集 ID。offset(必需):开始提取的行偏移量。 默认值为 0。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- get_database_object_description
获取指定架构中数据库对象(列、类型、密钥、索引)的结构,并以分层文本方式展示。
存在歧义时,返回所有适用对象的定义。
参数:
connectionId:唯一的连接 ID。databaseName:该架构所属数据库的名称。 如果 DBMS 仅有架构而无数据库,则可以为空。schemaName:架构名称。kind:将此参数设置为特定对象类型代码,仅列出对应类型的对象。 如需检索架构中的所有对象,将其设置为 null。objectName:指定类型的对象名称(如表或视图名)。 不得为空。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- 内省架构
内省数据库架构,将其元数据(表、列和索引)加载到本地模型中。 当架构的
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。
执行工具
- execute_run_configuration
在当前项目中通过名称运行已有运行配置,或从代码位置(
filePath+line)创建并运行临时运行配置,然后最多等待指定超时时间完成。 可使用此工具,通过get_run_configurations返回的配置名称,或通过get_run_configurations(filePath = ...)返回的运行点(filePath+line)进行运行。可选的启动重写配置(
programArguments、workingDirectory、envs)仅在本次运行中生效且不会被持久保存。 除非明确需要更改本次运行的启动参数,否则请勿传递这些重写参数。 缺省/空值重写参数会保留现有的运行配置值不变。 对于字符串重写(programArguments、workingDirectory),缺省/空字符串("")会保留当前值不变。 如需清空本次启动的已存在值,可传递仅包含空格的字符串,如" "。请传递
configurationName,或与line一起传递filePath。 这些模式互斥。行为:
当
waitForExit=true时,最多等待timeout毫秒以终止进程。 如超时,进程将在后台继续运行,exitCode将在结果中被省略。当
waitForExit=false时,仅等待进程启动,然后立刻返回,不应用timeout。fullOutputPath指向包含完整原始输出的临时文件,在进程运行时可能继续增长。
返回执行结果,包括当前输出快照、可选的退出代码和可选的
fullOutputPath。参数:
configurationName:要执行的现有运行配置名称。filePath:相对于项目根目录的文件路径。 请与line一起提供,以便从代码上下文创建并执行临时运行配置。line:filePath的从 1 开始的行号。 请与filePath一起提供,不要与configurationName同时使用。timeout:超时(毫秒)。waitForExit:是否等待进程终止。 如为 false,则工具在进程启动后立即返回,并忽略timeout。programArguments:本次启动可选的程序参数重写。 缺省/空字符串保留现有值,仅空格字符串会清空。workingDirectory:本次启动可选的工作目录重写。 缺省/空字符串保留现有值,仅空格字符串会清空。envs:本次启动可选的环境变量重写。 缺省/空值保留现有环境变量;如指定,则值会覆盖现有环境变量。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- get_run_configurations
根据输入,返回项目的运行配置或可执行代码位置。
未指定
filePath时,此工具列出项目的现有运行配置。 结果包含配置名称,以及在可用时包含启动详情,如程序参数、工作目录、环境变量和supportsDynamicLaunchOverrides。supportsDynamicLaunchOverrides是execute_run_configuration和xdebug_start_debugger_session中一次性启动重写(programArguments、workingDirectory、envs)的权威能力标志。 仅当该标志为true时才传递这些重写参数。指定
filePath时,此工具将在该文件中发现可执行入口点(运行点),如测试方法、主方法或 IDE 显示运行图标的其他可执行入口点。 结果包含filePath和runPoints;可搭配返回的行号用execute_run_configuration从代码运行。参数:
filePath:可选的相对于项目根目录的文件路径。 如指定,则返回文件中的运行点(可执行入口点),而非项目范围的运行配置。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
文件工具
- create_new_file
在项目目录中的指定路径创建新文件。 可选择将提供的文本写入该文件。
参数:
pathInProject:应创建文件的路径,相对于项目根目录。text(可选):要写入新文件的内容。overwrite:是否覆盖现有文件。 如果设置为false,发生冲突时将抛出异常。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- get_all_open_file_paths
返回在活动编辑器或任何其他已打开的编辑器中打开进行编辑的所有文件的路径,相对于项目根目录。 使用此工具探索当前打开的编辑器。
参数:
projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- list_directory_tree
以伪图形格式提供指定目录的树形表示,类似于
tree实用工具。 使用此工具浏览目录或整个项目的内容。 列出目录时,优先使用此工具,而非ls或dir等命令行实用工具。参数:
directoryPath:相对于项目根目录的路径。maxDepth:最大递归深度。timeout:超时(毫秒)。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- open_file_in_editor
在 JetBrains IDE 编辑器中打开指定文件。 需要一个
filePath参数,其中包含要打开的文件路径。 文件路径可以是绝对路径,也可以是相对于项目根目录的路径。参数:
filePath:相对于项目根目录的路径。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
格式设置工具
- reformat_file
在 JetBrains IDE 中重新格式化指定文件。 使用此工具对通过其路径标识的文件应用代码格式化。
参数:
path:相对于项目根目录的路径。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
检查生成器 MCP 工具
- validate_inspection_kts
根据规范示例验证 inspection.kts 脚本。 编译检查并以正/负示例运行。 返回编译状态和详细的验证结果。
正面示例应触发检查(预期有问题)。 负面示例不应触发检查(禁止行上不应有问题)。
返回整体是否成功、各示例结果及统计信息汇总。
参数:
inspectionKtsCode:要编译和验证的 inspection.kts 脚本内容。pathToSpecification:指向要进行验证的规范及示例的路径。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
检查 KTS MCP 工具
- generate_inspection_kts_api
返回目标语言的 Inspection KTS API 文档。 提供编写 inspection.kts 文件时可用的类和函数。
参数:
language:目标语言:'Java' 或 'Kotlin'。wrapInTags:如为 true,则会将 API 内容包裹在<API>与<api.kt>标签中。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- generate_inspection_kts_examples
返回目标语言的示例 inspection.kts 模板,以指导代码生成。 提供 XML 包裹的示例,展示如何使用 InspectionKts API 编写检查。
参数:
language:目标语言:'Java' 或 'Kotlin'。includeAdditionalExamples:如为 true,除模板外还包含其他精选示例。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- generate_psi_tree
为提供的 Java 或 Kotlin 代码创建 PSI 树,并以缩进文本返回。 在编写检查时,可使用此工具理解代码段的 PSI 结构。 输出展示元素类型及其层级关系,并提示何时需要
node.children()。参数:
code:要解析的源代码段。language:目标语言:'Java' 或 'Kotlin'。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- run_inspection_kts
编译 inspection.kts 脚本并在目标文件上运行。 如有编译错误则返回,否则返回检查发现的问题列表。 开发期间,可使用此工具测试 inspection.kts 脚本。
参数:
inspectionKtsCode:要编译和运行的 inspection.kts 脚本内容。contextPath:要分析的项目内目标文件的相对路径(例如, src/my/package/Example.kt )。targetFileContent:要分析的目标文件内容。 如果未提供,文件必须已存在于项目中。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
补丁工具
- apply_patch
应用 Codex
apply_patch格式或统一 Git diff 格式的补丁。 支持添加、删除和更新操作,并可为更新提供可选的移动目标路径。 路径必须保留在项目目录内。参数:
input:apply_patch格式或统一 Git diff 格式的补丁文本。patch:input的别名,用于兼容发送{patch: ...}的客户端。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
读取工具
- read_file
读取项目目录、任何项目依赖或其他项目源根中的文件。 可读取 Jar/Jrt 文件中的源代码,并反编译 Jar/Jrt 文件或磁盘上的 Java 类文件。 以文本形式返回带编号的行(从 1 开始)。
模式:
slicelinesline_columnsoffsetsindentation
模式详情:
slice使用start_line和max_lines。lines使用start_line/end_line(包含)。line_columns使用start_line/start_column和end_line/end_column(end为不包含;end_line默认为start_line)。offsets使用start_offset/end_offset(end为不包含)。indentation使用start_line,配合max_levels/include_*。
max_lines限制所有模式下的总输出;context_lines适用于区间模式(每侧)。参数:
file_path:文件路径。 支持相对于项目的路径、包含 '..' 的路径、绝对路径、如 /path/lib.jar!/pkg/Foo .class 的归档项,以及如 file:// 、 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:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
重构工具
- rename_refactoring
重命名指定文件中的符号(变量、函数、类等)。 使用此工具执行重命名重构操作。
与简单的文本查找并替换不同,
rename_refactoring工具是理解代码结构的上下文感知型实用工具。 它会智能更新整个项目中对指定符号的所有引用,确保代码完整性并防止引用失效。 它始终是重命名编程符号的首选方法。如果重命名操作成功,该工具将返回成功消息;如果找不到文件或符号,或重命名操作失败,则返回错误消息。
参数:
pathInProject:相对于项目根目录的路径。symbolName:要重命名的符号名称。newName:符号的新名称。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
搜索工具
- search_file
在项目中按 glob 模式搜索文件。 需要用 glob 语法匹配文件路径时,请使用该工具。
Glob 模式是相对于项目根目录的。
示例:
"**/*.kt""src/**/Foo*.java""build.gradle.kts"
不带
'/'的模式被视为"**/pattern"。paths是相对于项目根目录的可选额外 glob 筛选器。参数:
q:要搜索的 glob 模式。paths:可选的项目相对 glob 模式列表,用于过滤结果。 支持!排除。 以/结尾会扩展为**。 不带/的模式被视为**/pattern。 空字符串会被忽略。includeExcluded:是否在结果中包含被排除/忽略的文件。limit:返回结果的最大数量。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- search_regex
在项目文件中搜索正则表达式匹配项。 需要带有代码段结果的正则表达式搜索时,请使用该工具。 结果包括可用时的匹配坐标(基于 1 的行/列,基于 0 的偏移量)。
路径为相对于项目根目录的 glob 模式。
示例:
["src/**", "!**/test/**"]["**/*.kt"]["foo/"]
参数:
q:要搜索的正则表达式模式。paths:可选的项目相对 glob 模式列表,用于过滤结果。 支持!排除。 以/结尾会扩展为**。 不带/的模式被视为**/pattern。 空字符串会被忽略。limit:返回结果的最大数量。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- search_symbol
搜索符号(类、方法、字段)。 请使用该工具根据标识符片段进行语义查找。 结果包括可用时的匹配坐标(基于 1 的行/列,基于 0 的偏移量)。
路径为相对于项目根目录的 glob 模式。
默认只搜索项目符号。 如未找到合适结果,请重试并用
include_external=true搜索 SDK 和库符号。参数:
q:符号查询文本。paths:可选的项目相对 glob 模式列表,用于过滤结果。 支持!排除。 以/结尾会扩展为**。 不带/的模式被视为**/pattern。 空字符串会被忽略。include_external:是否包含 SDK 与库符号。 默认禁用;如未找到合适项,请重试并用include_external=true。limit:返回结果的最大数量。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- search_text
在项目文件中搜索文本子串。 请使用该工具进行快速文本搜索并获取代码段结果。 结果包括可用时的匹配坐标(基于 1 的行/列,基于 0 的偏移量)。
路径为相对于项目根目录的 glob 模式。
示例:
["src/**", "!**/test/**"]["**/*.kt"]["foo/"]
参数:
q:要搜索的文本。paths:可选的项目相对 glob 模式列表,用于过滤结果。 支持!排除。 以/结尾会扩展为**。 不带/的模式被视为**/pattern。 空字符串会被忽略。limit:返回结果的最大数量。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
技能搜索工具
- 搜索技能
使用显式模式执行统一项目搜索:
file:glob 路径搜索。text:字面内容搜索。regex:正则表达式内容搜索。symbol:语义符号查找。
默认情况下,符号搜索聚焦于项目。 如果没有找到合适的符号,请使用
include_external=true重试,以同时搜索 SDK 和库符号。参数:
mode(必需):搜索模式:file、text、regex或symbol。q(必需):搜索查询。 对于mode=file,这是 glob 模式。paths:可选的项目相对 glob 筛选器。 支持!-排除项和尾随/。include_external:是否为mode=symbol包含 SDK 和库符号。 默认禁用;如果未找到合适内容,请使用include_external=true重试。includeExcluded:是否包含已排除或已忽略的文件。 仅支持mode=file。limit:返回结果的最大数量。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
终端工具
- execute_terminal_command
在 IDE 的集成终端中执行指定的 shell 命令。 使用此工具在 IDE 环境中运行终端命令。
重要功能和限制:
在收集输出之前检查进程是否在运行。
将输出限制为 2000 行(超出部分将被截断)。
在指定的超时时间后超时,并发出通知。
除非在设置中启用了 Brave Mode ,否则需要用户确认。
返回的可能响应:
终端输出(超过 2000 行时将被截断)。
如果命令超时,输出将包含中断通知。
针对各种失败情况的错误消息。
参数:
command:要执行的 shell 命令。executeInShell:是否在用户的默认 shell(bash、zsh 等)中执行该命令。 如果该命令是 shell 脚本,或需要保留用户终端的真实环境,则非常有用。 如果设置为false,将以进程方式启动该命令。reuseExistingTerminalWindow:是否重用现有终端窗口,以避免创建多个终端。timeout:超时(毫秒)。maxLinesCount:返回的最大行数。truncateMode:如何截断文本:从开头、中间、末尾截断,或不截断。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
通用工具
- 执行工具
通用工具执行器,可从命令行字符串动态调用特定 IDE MCP 工具。
参数:
command(必需):包含工具名称和实参的命令行字符串。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
VCS 工具
- get_repositories
检索项目中的 VCS 根目录列表。 在多仓库项目中使用此工具识别所有仓库。
参数:
projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。
- Git 状态
检索当前项目中一个或多个仓库的 Git 状态。 返回 porcelain 风格的索引和工作树状态代码以及摘要计数器。 默认情况下,返回所有 Git 仓库。
参数:
repositoryPathRelativeToProject:相对于项目根目录的可选路径,用于选择单个包含它的仓库。includeUntracked:是否包含未跟踪的文件。includeIgnored:是否包含已忽略的文件。limit:每个仓库返回的最大条目数。projectPath:项目路径。 如已知,请始终提供此值,以减少歧义调用。 如果仅知道当前工作目录,您可以将其用作项目路径。