MCP servers

Servidores MCP (stdio) para agentes/clientes como Zed e Claude Desktop. Cada um é um módulo independente; os Go têm go.mod próprio, o anydoc é Rust com Cargo.toml.

Tools

• git: git_repo_info, git_status, git_log, git_show, git_diff, git_refs, git_blame, git_tree, git_read_file, git_find_commits
• github: github_search, github_get_tree, github_read_file, github_repo_info, github_get_item
• sqlize: sqlize_import, sqlize_structure, sqlize_query, sqlize_export (+ postgres_*/mysql_*)
• anydoc: anydoc_read
• sandbox: sandbox_run (run por path/code + args), sandbox_doc (API std), sandbox_os (copy/mount/del/stat/list)

Variáveis de ambiente

O filesystem do sandbox (mnt) e a exportação do sqlize ficam fixos em ~/.local/state/mcp/mnt (pasta compartilhada, sem env): o mnt do sandbox é ~/.local/state/mcp/mnt e tmp é ~/.local/state/mcp/tmp.

CLI sandbox.exe

Além do servidor MCP, o sandbox pode ser usado como CLI para rodar scripts .lua direto no terminal (sem IA):

sandbox.exe script.lua
sandbox.exe script.lua --args '{"nome":"Ava","n":3}'
sandbox.exe script.lua --json        # resultado completo em JSON (para automação)
sandbox.exe script.lua --timeout 30

• --args (JSON) vira std.args; sem ele, os argumentos posicionais viram um array.
• --json imprime o RunResult inteiro (ok, name, desc, output, data, error).
• mnt/ e tmp/ são os mesmos do servidor (~/.local/state/mcp/mnt e .../tmp), persistidos entre execuções; tmp/ é limpo a cada execução.
• Código de saída: 0 sucesso, 1 erro, 2 uso incorreto.

Build: task build:sandbox-cli (gera dist/sandbox.exe).

Exemplo (Zed)

{
  "context_servers": {
    "git":     { "command": "~/.local/bin/git-mcp.exe" },
    "github":  { "command": "~/.local/bin/github-mcp.exe", "env": { "GITHUB_TOKEN": "" } },
    "sqlize":  { "command": "~/.local/bin/sqlize-mcp.exe" },
    "sandbox": { "command": "~/.local/bin/sandbox-mcp.exe" },
    "anydoc":  { "command": "~/.local/bin/anydoc-mcp.exe" }
  }
}

Build: task build gera os executáveis em dist/. Logs: ~/.local/state/mcp/logs/.