use_mcp_tool

use_mcp_tool 工具使 Kilo Code 能够与连接的 Model Context Protocol (MCP) 服务器提供的外部工具进行交互。它通过标准化协议扩展了 Kilo Code 的功能，提供特定领域的专业能力。

参数

该工具接受以下参数：

server_name（必填）：提供工具的 MCP 服务器名称
tool_name（必填）：要执行的工具名称
arguments（必填/可选）：包含工具输入参数的 JSON 对象，遵循工具的输入模式。对于不需要输入的工具，此参数可为可选。

功能

该工具允许 Kilo Code 访问由外部 MCP 服务器提供的专业功能。每个 MCP 服务器可以提供多个具有独特功能的工具，从而扩展 Kilo Code 的内置功能。系统会根据模式验证参数，管理服务器连接，并处理各种内容类型的响应（文本、图像、资源）。

使用场景

当需要核心工具无法提供的专业功能时
当需要特定领域的操作时
当需要与外部系统或服务集成时
当处理需要特定处理或分析的数据时
当通过标准化接口访问专有工具时

主要特性

使用 @modelcontextprotocol/sdk 库的标准化 MCP 协议
支持多种通信机制（StdioClientTransport 和 SSEClientTransport）
在客户端和服务器端使用 Zod 模式验证参数
处理多种响应内容类型：文本、图像和资源引用
当服务器代码更改时自动重启，管理服务器生命周期
提供“始终允许”机制以绕过受信任工具的批准
与配套的 access_mcp_resource 工具协同工作以获取资源
维护适当的错误跟踪和处理机制
支持可配置的超时时间（1-3600 秒，默认：60 秒）
允许文件监视器自动检测和重新加载服务器更改

限制

依赖外部 MCP 服务器的可用性和连接性
仅限于连接服务器提供的工具
不同 MCP 服务器的工具能力各不相同
网络问题可能影响可靠性和性能
需要用户批准才能执行（除非在“始终允许”列表中）
无法同时执行多个 MCP 工具操作

服务器配置

MCP 服务器可以在全局或项目级别进行配置：

全局配置：通过 VS Code 中的 Kilo Code 扩展设置进行管理。这些设置适用于所有项目，除非被覆盖。
项目级配置：在项目根目录下的 .kilocode/mcp.json 文件中定义。
- 这允许项目特定的服务器设置。
- 如果项目级服务器与全局服务器同名，则项目级服务器优先。
- 由于 .kilocode/mcp.json 可以提交到版本控制，因此简化了与团队共享配置的过程。

工作原理

当调用 use_mcp_tool 工具时，它会遵循以下流程：

初始化和验证：
- 系统验证 MCP hub 是否可用
- 确认指定的服务器存在并已连接
- 验证请求的工具存在于服务器上
- 根据工具的模式定义验证参数
- 从服务器配置中提取超时设置（默认：60 秒）
执行和通信：
- 系统选择适当的通信机制：
  - StdioClientTransport：用于通过标准 I/O 与本地进程通信
  - SSEClientTransport：用于通过 Server-Sent Events 与 HTTP 服务器通信
- 发送包含已验证的服务器名称、工具名称和参数的请求
- 使用 @modelcontextprotocol/sdk 库进行标准化交互
- 跟踪请求执行并处理超时，防止挂起操作
响应处理：
- 响应可以包含多种内容类型：
  - 文本内容：纯文本响应
  - 图像内容：带有 MIME 类型信息的二进制图像数据
  - 资源引用：用于访问服务器资源的 URI（与 access_mcp_resource 协同工作）
- 系统检查 isError 标志以确定是否需要错误处理
- 结果会被格式化以在 Kilo Code 界面中显示
资源和错误处理：
- 系统使用 WeakRef 模式防止内存泄漏
- 连续错误计数器跟踪和管理错误
- 文件监视器监控服务器代码更改并触发自动重启
- 安全模型要求批准工具执行，除非在“始终允许”列表中

安全和权限

MCP 架构提供了多项安全功能：

默认情况下，用户必须在执行前批准工具使用
特定工具可以标记为“始终允许”列表中的自动批准
使用 Zod 模式验证服务器配置以确保完整性
可配置的超时时间防止挂起操作（1-3600 秒）
可以通过 UI 启用或禁用服务器连接

使用示例

使用文本响应请求天气预报数据：

<use_mcp_tool>
<server_name>weather-server</server_name>
<tool_name>get_forecast</tool_name>
<arguments>
{
  "city": "San Francisco",
  "days": 5,
  "format": "text"
}
</arguments>
</use_mcp_tool>

使用返回 JSON 的专用工具分析源代码：

<use_mcp_tool>
<server_name>code-analysis</server_name>
<tool_name>complexity_metrics</tool_name>
<arguments>
{
  "language": "typescript",
  "file_path": "src/app.ts",
  "include_functions": true,
  "metrics": ["cyclomatic", "cognitive"]
}
</arguments>
</use_mcp_tool>

使用特定参数生成图像：

<use_mcp_tool>
<server_name>image-generation</server_name>
<tool_name>create_image</tool_name>
<arguments>
{
  "prompt": "A futuristic city with flying cars",
  "style": "photorealistic",
  "dimensions": {
    "width": 1024,
    "height": 768
  },
  "format": "webp"
}
</arguments>
</use_mcp_tool>

通过返回资源引用的工具访问资源：

<use_mcp_tool>
<server_name>database-connector</server_name>
<tool_name>query_and_store</tool_name>
<arguments>
{
  "database": "users",
  "type": "select",
  "fields": ["name", "email", "last_login"],
  "where": {
    "status": "active"
  },
  "store_as": "active_users"
}
</arguments>
</use_mcp_tool>

不需要参数的工具：

<use_mcp_tool>
<server_name>system-monitor</server_name>
<tool_name>get_current_status</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

参数​

功能​

使用场景​

主要特性​

限制​

服务器配置​

工作原理​

安全和权限​

使用示例​

参数

功能