convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
caged-dev

Caged MCP Server

caged-dev/mcp-server

Sandbox MCP para agentes de IA com controle total e segurança integrada

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP standalone que expõe ferramentas de sandbox isolado para agentes de IA. Fornece acesso controlado a operações de filesystem, terminal, git e requisições HTTP, com suporte nativo a Claude Code, Cursor e Aider. Implementa segurança via path sandboxing, allowlisting de comandos e modo read-only.

Instalação

$npx convez-ai caged-dev/mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
62%
Último commit
há 1 mês
Versão
v0.1.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Agentes de IA executando tarefas de desenvolvimento em ambiente isolado
  • DevOps e CI/CD: controlar execução de scripts em sandbox seguro
  • Exploração segura de repositórios por IA sem risco de modificações não autorizadas

Veredito

MCP server bem arquitetado em Go com segurança por design (path sandboxing, allowlisting, read-only). Ideal para integrar agentes de IA em pipelines DevOps onde isolamento é crítico. Documentação clara e múltiplos modos de deploy (stdio, WebSocket, Docker).

README

A tradução para o português deste README ainda está na fila.

caged-mcp

A standalone Model Context Protocol (MCP) server that exposes sandbox tools to AI coding agents. Compatible with Claude Code, Cursor, Aider, and any MCP-compatible client.

What This Does

This MCP server provides AI agents with tools to interact with an isolated sandbox environment:

ToolDescription
filesystem_readRead file contents
filesystem_writeWrite/create files
filesystem_listList directory contents
filesystem_deleteRemove files/directories
filesystem_searchSearch for files by pattern
terminal_execExecute shell commands
terminal_interactiveStart interactive terminal sessions
git_statusGet git repository status
git_diffShow file changes
git_commitCreate commits
git_logView commit history
network_fetchMake HTTP requests

Installation

# Pre-built binary
curl -fsSL https://github.com/caged-dev/mcp-server/releases/latest/download/caged-mcp-linux-amd64 -o /usr/local/bin/caged-mcp
chmod +x /usr/local/bin/caged-mcp

# From source
go install github.com/caged-dev/mcp-server@latest

# Docker
docker pull ghcr.io/caged-dev/mcp-server:latest

Usage

With Caged Platform (Recommended)

The MCP server is built into the Caged platform. Connect via WebSocket:

wss://api.caged.dev/v1/sandboxes/{id}/mcp?token={session_token}

Standalone Mode

Run the MCP server locally, pointing at any directory:

# Serve current directory over stdio (for direct MCP client connection)
caged-mcp --mode stdio --workspace /path/to/project

# Serve over WebSocket on port 9090
caged-mcp --mode ws --port 9090 --workspace /path/to/project

Claude Code Configuration

Add to your ~/.claude/mcp_servers.json:

{
  "caged": {
    "command": "caged-mcp",
    "args": ["--mode", "stdio", "--workspace", "/path/to/project"]
  }
}

Cursor Configuration

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "caged": {
      "command": "caged-mcp",
      "args": ["--mode", "stdio", "--workspace", "."]
    }
  }
}

Configuration

FlagEnvDefaultDescription
--modeCAGED_MCP_MODEstdioTransport: stdio or ws
--portCAGED_MCP_PORT9090WebSocket listen port
--workspaceCAGED_MCP_WORKSPACE.Root workspace directory
--allowed-commandsCAGED_MCP_ALLOWED_COMMANDS(all)Comma-separated allowed shell commands
--read-onlyCAGED_MCP_READ_ONLYfalseDisable write/exec tools
--log-levelCAGED_MCP_LOG_LEVELinfoLog level

Security

The MCP server enforces:

  • Path sandboxing: All file operations are confined to the workspace directory. Path traversal (../) is blocked.
  • Command allowlisting: Optionally restrict which shell commands can be executed.
  • Read-only mode: Disable all write operations for safe exploration.
  • No network by default: The network_fetch tool must be explicitly enabled.

Building

go build -o caged-mcp ./cmd/mcp-server

# Cross-compile for Linux
GOOS=linux GOARCH=amd64 go build -o caged-mcp ./cmd/mcp-server

Development

go test ./...
go test -race ./...
golangci-lint run

Protocol

Implements the Model Context Protocol specification (version 2024-11-05).

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados