Strands Agents MCP Server

---

此 MCP 服务通过 llms.txt 文件，为你的 GenAI 工具提供精选文档访问能力，使 AI 编码助手能够通过智能排序搜索并检索相关文档。

功能

• 智能文档搜索：基于 TF-IDF 的搜索，采用 Markdown 感知评分，优先考虑标题、页眉和代码块
• 按章节浏览：通过目录浏览文档结构，然后仅获取所需章节；与检索完整页面相比，更节省 token
• 精选内容：索引来自 llms.txt 文件的文档，并提供清晰易读的标题
• 按需获取：仅在需要时延迟加载完整文档内容，以获得最佳性能
• 片段生成：提供带相关性评分的上下文片段，便于快速概览
• 支持真实 URL：可使用实际 HTTPS URL，同时保持向后兼容

前置条件

以下使用方法要求你的系统已安装 uv。你可以按照官方安装说明进行安装。

安装

你可以将 Strands Agents MCP 服务与40 多款支持 MCP 服务的应用搭配使用，包括 Amazon Q Developer CLI、Anthropic Claude Code、Cline 和 Cursor。

点击下方的按钮，即可通过热门 MCP 客户端的一键安装按钮快速开始。点击下方按钮可直接在 IDE 中安装服务：

Kiro 示例

请参阅 Kiro 文档，了解如何管理 MCP 配置。

在 ~/.kiro/settings/mcp.json 中：

{
  "mcpServers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO"
      },
      "disabled": false,
      "autoApprove": ["search_docs", "fetch_doc"]
    }
  }
}

Q Developer CLI 示例

请参阅 Q Developer CLI 文档，了解如何管理 MCP 配置。

在 ~/.aws/amazonq/mcp.json 中：

{
  "mcpServers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO"
      },
      "disabled": false,
      "autoApprove": ["search_docs", "fetch_doc"]
    }
  }
}

Claude Code 示例

请参阅 Claude Code 文档，了解如何管理 MCP 服务。

claude mcp add strands uvx strands-agents-mcp-server

Cline 示例

请参阅 Cline 文档，了解如何管理 MCP 配置。

向 Cline 提供以下信息：

I want to add the MCP server for Strands Agents.
Here's the GitHub link: @https://github.com/strands-agents/mcp-server
Can you add it?"

Cursor 示例

请参阅 Cursor 文档，了解如何管理 MCP 配置。

在 ~/.cursor/mcp.json 中：

{
  "mcpServers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"],
      "env": {
        "FASTMCP_LOG_LEVEL": "INFO"
      },
      "disabled": false,
      "autoApprove": ["search_docs", "fetch_doc"]
    }
  }
}

VS Code 示例

请参阅 VS Code 文档，了解如何管理 MCP 配置。

在你的 mcp.json 文件中：

{
  "servers": {
    "strands-agents": {
      "command": "uvx",
      "args": ["strands-agents-mcp-server"]
    }
  }
}

快速测试

你可以使用 MCP Inspector 快速测试 MCP 服务：

# For published package
npx @modelcontextprotocol/inspector uvx strands-agents-mcp-server

# For local development
npx @modelcontextprotocol/inspector python -m strands_mcp_server

注意：这需要在系统上安装 npx。它已随 Node.js 一同捆绑提供。

Inspector 还可用于排查 MCP 服务问题，因为它会提供详细的连接和协议信息。如需深入了解，请参阅 MCP Inspector 文档。

入门

1. 安装先决条件：

   • 按照官方安装说明安装 uv
   • 确保已安装 Node.js，以便运行 npx 命令

2. 配置 MCP 客户端：

   • 从上述安装示例中选择你偏好的 MCP 客户端
   • 将 Strands Agents MCP 服务配置添加到客户端

3. 测试连接：

   # For published package
   npx @modelcontextprotocol/inspector uvx strands-agents-mcp-server
   
   # For local development
   npx @modelcontextprotocol/inspector python -m strands_mcp_server
   

4. 开始使用文档工具：

   • search_docs - 通过智能排序查找相关文档
   • fetch_doc - 浏览页面结构和前言，然后阅读各个章节
   • 服务会自动索引 llms.txt 文件中的精选内容

服务开发

git clone https://github.com/strands-agents/mcp-server.git
cd mcp-server
python3 -m venv venv
source venv/bin/activate
pip3 install -e ".[dev]"

npx @modelcontextprotocol/inspector python -m strands_mcp_server

运行测试

# Unit tests (fast, no network access required)
pytest tests/

# Integration tests (requires network access to strandsagents.com)
pytest tests_integ/ -v

# All tests
pytest tests/ tests_integ/ -v

若要跳过集成测试（例如，在无法访问网络的 CI 环境中）：

SKIP_INTEG_TESTS=1 pytest tests_integ/

参与贡献 ❤️

欢迎参与贡献！有关以下内容的详情，请参阅我们的贡献指南：

• 报告错误和功能需求
• 开发环境设置
• 通过 Pull Request 参与贡献
• 行为准则
• 报告安全问题

与团队保持联系

欢迎加入 Discord，与 Strands 团队和其他用户交流。

许可证

本项目根据 Apache License 2.0 许可，详情请参阅 LICENSE 文件。

安全

有关更多信息，请参阅 CONTRIBUTING。