项目简介

Swarm Scout MCP 服务器是 'Swarm Scout' 项目的一部分，旨在将 'Scout' 代理的能力通过 Model Context Protocol (MCP) 暴露给其他 LLM 驱动的客户端。这意味着其他代理（例如 Claude Desktop）可以通过调用 'Scout' MCP 服务器提供的工具来获取代码库上下文、执行文件搜索和代码分析。它实现了递归代理模式，允许复杂的上下文查找任务委托给专门的子代理。

主要功能点

工具暴露: 将 'Scout' 代理的 'scout_query' 功能和自定义代理（如 'agent_context_agent'）封装成 MCP 工具，供外部 LLM 客户端调用。
上下文发现: 允许 LLM 客户端通过这些工具提交自然语言查询，以在代码库中查找文件、理解代码结构、分析功能实现等。
JSON-RPC 通信: 通过标准 JSON-RPC 协议与 MCP 客户端进行通信，支持 Stdio 等传输协议。
模块化设计: 作为 'Swarm Scout' 框架的一部分，能够集成 'Scout' 的 Bash 执行、Ripgrep 搜索、LLM 路由等底层功能。

安装步骤

安装 Scout CLI: 首先需要全局安装 'Swarm Scout' 命令行工具。

npm install -g swarm-scout

安装 Scout MCP 服务器 (Python 包):

pip install scout-mcp

或者，如果您使用的是 'uvx' (一个轻量级的 Python 环境管理器，无需本地安装 Python):

# 无需额外安装，直接在MCP客户端配置中使用uvx命令

服务器配置

'Scout' MCP 服务器通常不会直接运行，而是被 MCP 客户端（如 Claude Desktop）按需启动。以下是 MCP 客户端配置 'Scout' MCP 服务器的示例（以 Claude Desktop 为例，在 '~/Library/Application Support/Claude/claude_desktop_config.json' 文件中）：

{
  "mcpServers": {
    "scout": {
      "command": "scout-mcp",
      "args": [],
      "type": "stdio"
    }
  }
}

说明：

'scout': 这是您为该 MCP 服务器定义的名称，可以在客户端调用工具时使用。
'command': 指定启动 'scout-mcp' 服务器的命令。如果您通过 'pip install scout-mcp' 安装，命令通常是 'scout-mcp'。如果您选择使用 'uvx'，命令可能是 'uvx'，'args' 中包含 'scout-mcp'。
'args': 传递给 'command' 的额外参数。对于 'scout-mcp'，通常不需要额外参数。
'type': 指明 MCP 服务器使用的通信方式，'"stdio"' 表示标准输入输出流。

配置完成后，您的 MCP 客户端将能够检测并调用 'Scout' MCP 服务器提供的工具。

基本使用方法

在配置了 'Scout' MCP 服务器的 LLM 客户端（如 Claude Desktop）中，您可以直接通过自然语言提示来调用 'Scout' 提供的工具。例如，您可以这样向 LLM 提问：

"使用 'scout_query' 工具查找所有异步函数。"
"让 'agent_context_agent' 代理解释认证系统是如何工作的。"
"通过 'scout_query' 工具，展示所有 API 端点。"

LLM 客户端会识别并调用相应的 MCP 工具 ('scout_query' 或 'agent_context_agent' 等)，'Scout' MCP 服务器将执行底层 'Scout' 命令，并将结果返回给 LLM 客户端。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息