convez.ai
MCP ServerDevOps & InfraestruturaAvançado
wbind-core

TermPipe MCP Server

wbind-core/termpipe-mcp

Automação de sistemas e debugging assistido por IA via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP production-ready que fornece acesso a terminal, edição cirúrgica de arquivos, gerenciamento de processos e debugging assistido por IA. Integra-se nativamente com Claude Desktop para automação inteligente de sistemas e desenvolvimento assistido.

Instalação

$npx convez-ai wbind-core/termpipe-mcp

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
28%
Último commit
há 1 semana
Versão
—
Issues abertas
2
Contribuidores
1

Casos de uso

  • Execução de comandos shell e automação de tarefas via Claude
  • Edição cirúrgica de arquivos com feedback de deltas de linha
  • Debugging assistido com integração a iFlow e Gemini
  • Gerenciamento de processos e sessões de terminal
  • Automação de fluxos de trabalho em DevOps e desenvolvimento

Veredito

TermPipe é um MCP server robusto e bem-arquitetado para quem precisa integrar Claude em fluxos de automação de sistemas complexos. Sua abordagem modular, hot-reload e feedback de deltas de linha o torna prático para desenvolvimento iterativo, mas exige expertise em terminal e Python para maximizar seu potencial.

README

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

TermPipe MCP Server

MCP server for Claude Desktop providing surgical file editing, shell execution, AI debugging, and more.


Architecture

/home/craig/termpipe-mcp/          ← CANONICAL SOURCE (edit here)
  termpipe_mcp/
    server.py                      ← FastMCP entry point (stdio)
    tools/
      surgical.py                  ← Line-level file editing
      system.py                    ← list_tools, reload_tools, etc.
      files.py                     ← read/write/list
      termf.py                     ← Shell execution
      debug.py                     ← iFlow debug assist
      gemini_debug.py              ← Gemini debug assist
      ... (all tool modules)

~/.termpipe/mcp_server/tools/      ← SYMLINK → termpipe_mcp/tools/

~/.termpipe/mcp_server/tools/ is a symlink to termpipe_mcp/tools/.
Edit files in either location — they are the same files.


How Claude Desktop Runs It

From ~/.config/Claude/claude_desktop_config.json:

"termpipe": {
  "command": "/home/craig/.local/share/pipx/venvs/termpipe-mcp/bin/python",
  "args": ["-m", "termpipe_mcp.server"],
  "env": { "TERMCP_URL": "http://localhost:8421" }
}

The pipx venv is installed in editable mode pointing to /home/craig/termpipe-mcp/.
Edits to .py files take effect on next restart — no reinstall needed.


Applying Changes

Option A — Restart Claude Desktop

Kills and respawns the stdio server process. Always picks up changes.

Option B — Hot Reload (no restart)

Ask Claude to call reload_tools(). It will:

  1. importlib.reload() every tool module
  2. Clear FastMCP's tool registry
  3. Re-register all tools in-place

Useful for mid-session edits. Note: changes to server.py itself still require a full restart.


Adding a New Tool

  1. Open the relevant module in termpipe_mcp/tools/ (or create a new one)
  2. Add your @mcp.tool() function inside register_tools(mcp):
  3. If new module: import and call register_tools(mcp) in server.py
  4. Call reload_tools() or restart Claude Desktop

list_tools() is dynamic — it introspects the live FastMCP registry, so new tools appear automatically without editing any manifest.


Tool Categories

CategoryModuleDescription
SURGICALsurgical.pyLine-level file editing
FILEfiles.pyRead/write/list/move
TERMFtermf.pyShell command execution
DEBUGdebug.pyiFlow AI debug assist
GEMINIgemini_debug.pyGemini AI debug/analyze
PROCESSprocess.pySession/process management
IFLOWiflow.pyiFlow AI backend
SYSTEMsystem.pylist_tools, reload_tools, config
SEARCHsearch.pyFile content search
APPSapps.pyApp launcher
WBINDwbind.pyWayland GUI automation
THREADthread.pyThread coordination log
WEB_SEARCHweb_search.pyWeb search

Key Surgical Tool Behaviors (v2.3)

  • Line delta feedback: Every mutating tool (replace_lines, insert_lines, delete_lines, etc.) returns 📊 File: N → M lines (delta: ±X) so models track shifted line numbers across sequential edits.
  • smart_replace: Operates on full file content — supports multi-line old_text spans.
  • replace_at_line: Multi-occurrence lines — replaces first by default, pass replace_all=True for all.
  • list_tools: Dynamic — reads live FastMCP registry, never stale.
  • reload_tools: Hot-reload all modules in-place without restarting Claude Desktop.

FastAPI Backend

The FastAPI backend (termf server / termcp server) runs separately on port 8421.
The MCP server connects to it via TERMCP_URL=http://localhost:8421.
Check status: termcp status

Ver o original no GitHub

Bom para

Relacionados