scout_mcp

@jmagar/scout_mcp

0 Stars 168 次浏览 jmagar 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "scout_mcp": {
      "args": [
        "run",
        "--directory",
        "/code/scout_mcp",
        "python",
        "-m",
        "scout_mcp"
      ],
      "command": "uv"
    }
  }
}

服务介绍

Scout MCP

MCP server for remote file operations via SSH. Scout your fleet of machines with a single tool.

Installation

# Clone and install
git clone <repo-url>
cd scout_mcp
uv sync

Configuration

Scout MCP reads your ~/.ssh/config to discover available hosts. Optionally configure limits:

# Environment variables (optional)
export MCP_CAT_MAX_FILE_SIZE=5242880  # 5MB (default: 1MB)
export MCP_CAT_COMMAND_TIMEOUT=60      # seconds (default: 30)
export MCP_CAT_IDLE_TIMEOUT=120        # seconds (default: 60)

Current defaults:

Max file size: 1MB (1,048,576 bytes)
Command timeout: 30 seconds
Idle timeout: 60 seconds

Usage

Add to your Claude Code MCP config:

{
  "mcpServers": {
    "scout_mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/code/scout_mcp", "python", "-m", "scout_mcp"]
    }
  }
}

Tool: scout

List available hosts

scout("hosts")

Cat a file

scout("hostname:/path/to/file.log")

List a directory

scout("hostname:/path/to/directory")

Run a command

scout("hostname:/working/dir", "rg 'pattern' -t py")
scout("hostname:~/code", "find . -name '*.md' -mtime -1")
scout("hostname:/var/log", "tail -100 app.log | grep ERROR")

Development

# Run tests
uv run pytest tests/ -v

# Lint and type check
uv run ruff check scout_mcp/ tests/
uv run mypy scout_mcp/

# Run server locally
uv run python -m scout_mcp

License

MIT

查看源码项目主页