工具（Tools）

本指南将介绍如何在 Kiro 中高效使用 Model Context Protocol（MCP）工具，以提升你的工作效率并获取专业能力。

与 MCP 工具交互的方式

在你完成了 MCP 服务器配置 后，可以通过多种方式与 MCP 工具交互：

直接提问

最简单的方式是直接围绕 MCP 服务器相关领域提出问题：

  1. Tell me about Amazon Bedrock  
  2. （告诉我关于 Amazon Bedrock 的信息）
  4. How do I configure S3 bucket policies?  
  5. （我该如何配置 S3 bucket 策略？）

Kiro 会根据你的问题自动选择合适的 MCP 工具。

指定工具请求

你也可以通过明确描述来请求使用某个 MCP 工具：

  1. Search AWS documentation for information about ECS task definitions  
  2. （在 AWS 文档中搜索有关 ECS 任务定义的信息）
  4. Get recommendations for AWS CloudFormation best practices  
  5. （获取关于 AWS CloudFormation 最佳实践的推荐）

显式上下文格式

如果你想拥有更多控制权，可以使用显式格式来指定服务器和工具：

  1. #[aws-docs] search_documentation Tell me about AWS Lambda  
  2. （在 aws-docs 服务器上使用 search_documentation 工具告诉我关于 AWS Lambda 的信息）

这个格式指定了服务器（aws-docs）和工具（search_documentation）。

MCP 工具面板

Kiro 的面板中包含一个 MCP Servers 标签页，它提供以下功能：

  • 显示所有已配置的 MCP 服务器列表
  • 展示连接状态（在线或离线）
  • 快速访问各服务器的工具列表

使用方法：

  1. 点击侧边栏中的 Kiro 图标
  2. 切换到 MCP Servers 标签页
  3. 点击任何工具名称，即可在聊天框中插入一个占位提示（prompt）

工具使用审批流程

当 Kiro 想使用某个 MCP 工具时，它会先请求你的许可：

  1. 你会看到一个描述该工具用途的提示
  2. 仔细查看工具详情和参数
  3. 点击 “Approve（批准）” 允许执行，或点击 “Deny（拒绝）” 禁止执行

自动批准可信工具

如果你不想每次都批准相同的工具，可以将其添加到 autoApprove 列表中：

  1. 打开 MCP 配置文件
  2. 添加要自动批准的工具名到 autoApprove 数组中：
  1. {
  2.   "mcpServers": {
  3.     "aws-docs": {
  4.       "autoApprove": [
  5.         "mcp_aws_docs_search_documentation",
  6.         "mcp_aws_docs_read_documentation"
  7.       ]
  8.     }
  9.   }
  10. }
  1. 重启 Kiro，使更改生效

各类型服务器的使用示例

AWS Documentation Server

搜索文档

  1. Search AWS documentation for S3 bucket versioning  
  2. （搜索 AWS 文档中关于 S3 版本控制的内容）

使用工具：mcp_aws_docs_search_documentation

阅读文档

  1. Read the AWS Lambda function URLs documentation  
  2. （阅读 AWS Lambda 函数 URL 的相关文档）

使用工具：mcp_aws_docs_read_documentation

获取推荐内容

  1. Find related content to AWS ECS task definitions  
  2. （查找与 AWS ECS 任务定义相关的内容）

使用工具：mcp_aws_docs_recommend

GitHub MCP Server

仓库信息

  1. Show me information about the tensorflow/tensorflow repository  
  2. （告诉我关于 tensorflow/tensorflow 仓库的信息）

代码搜索

  1. Find examples of React hooks in facebook/react  
  2. （在 facebook/react 中找一些 React hooks 的示例代码）

Issue 管理

  1. Create an issue in my repository about the login bug  
  2. （在我的仓库中创建一个关于登录错误的 issue）

高级用法技巧

链式调用 MCP 工具

你可以将多个 MCP 工具串联使用，完成复杂任务：

  1. First search AWS documentation for ECS task definitions,  
  2. then find related content about service discovery  
  3. （先搜索 AWS 文档中的 ECS 任务定义，再查找有关服务发现的相关内容）

结合本地上下文使用

结合你本地项目代码，MCP 工具会发挥更大作用：

  1. Based on my Terraform code,  
  2. help me optimize my AWS Lambda configuration using best practices from AWS documentation  
  3. （基于我的 Terraform 代码，帮我优化 AWS Lambda 配置，参考 AWS 文档中的最佳实践）

在 Specs 中使用 MCP 工具

你可以在 Kiro Specs 规范文档中使用 MCP 工具提升开发流程质量：

  1. In the implementation phase,  
  2. use AWS documentation to ensure our S3 bucket configuration follows best practices  
  3. （在实现阶段，使用 AWS 文档确保我们的 S3 bucket 配置符合最佳实践）

工具使用问题排查

工具无响应

  1. 检查 Kiro 面板中的 MCP 服务器连接状态
  2. 查看 MCP 日志，看是否有报错
  3. 必要时重启 MCP 服务器

结果不准确

  1. 尝试换一种更明确的表达方式
  2. 检查是否选用了合适的工具
  3. 确保 MCP 服务器具备所需的权限

工具不可用

  1. 确保 MCP 服务器已正确配置
  2. 检查服务器是否在运行，并已连接
  3. 确保你拥有使用该工具的权限

最佳实践

  • 请求尽量具体，以获取最相关的结果
  • 从直接提问开始，再逐步使用工具指令
  • 只自动批准你信任的工具，避免安全风险
  • 将 MCP 工具与本地上下文结合使用，效果最佳
  • 在批准工具前检查参数是否正确