zentrix-mcp 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +123 -2
- package/bin/agent-cli.js +138 -0
- package/package.json +24 -3
package/README.md
CHANGED
|
@@ -1,3 +1,124 @@
|
|
|
1
|
-
#
|
|
1
|
+
# IDE Commander MCP
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Servidor **MCP (Model Context Protocol)** próprio estilo [Desktop Commander](https://desktopcommander.app/) para conectar **Claude Desktop**, **ChatGPT**, **Cursor**, **Claude Code** e outros clientes MCP diretamente ao seu computador — com leitura/criação/edição cirúrgica de arquivos, busca em código, terminal interativo, controle de processos e guardas de segurança.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Ferramentas disponíveis (21 tools)
|
|
8
|
+
|
|
9
|
+
### Arquivos & Edição (estilo IDE)
|
|
10
|
+
- `read_file` — Lê arquivos com numeração de linha, `offset` (inclusive negativo para ler as últimas N linhas) e `length`
|
|
11
|
+
- `read_multiple_files` — Lê vários arquivos em uma única chamada
|
|
12
|
+
- `write_file` — Cria, sobrescreve (`rewrite`) ou anexa (`append`) arquivos criando pastas pai automaticamente
|
|
13
|
+
- `edit_block` — Edição cirúrgica search-and-replace com suporte a CRLF/LF e verificação de `expected_replacements`
|
|
14
|
+
- `create_directory` — Cria pastas recursivamente
|
|
15
|
+
- `list_directory` — Lista diretórios em árvore com controle de profundidade (`depth`)
|
|
16
|
+
- `move_file` — Move ou renomeia arquivos e pastas
|
|
17
|
+
- `delete_file` — Remove arquivos ou diretórios (`recursive: true` para pastas)
|
|
18
|
+
- `get_file_info` — Metadados (tamanho, datas, tipo, contagem de linhas)
|
|
19
|
+
|
|
20
|
+
### Busca
|
|
21
|
+
- `search_files` — Busca arquivos por nome/glob (`*.ts`, `package.json`, etc.)
|
|
22
|
+
- `search_code` — Busca texto ou Regex dentro de arquivos (estilo `ripgrep`) com filtro por extensão
|
|
23
|
+
|
|
24
|
+
### Terminal & Processos
|
|
25
|
+
- `start_process` — Executa comandos ou inicia servidores em background (retorna `pid` se continuar rodando)
|
|
26
|
+
- `read_process_output` — Lê novas saídas (`stdout`/`stderr`) de um processo em execução
|
|
27
|
+
- `interact_with_process` — Envia texto para o `stdin` de processos interativos (REPLs, prompts, CLIs)
|
|
28
|
+
- `list_sessions` — Lista todas as sessões de terminal iniciadas pelo MCP
|
|
29
|
+
- `force_terminate` — Encerra um processo e toda a árvore de filhos (`taskkill /T /F` no Windows)
|
|
30
|
+
- `list_processes` — Lista processos do sistema operacional com filtro
|
|
31
|
+
- `kill_process` — Mata qualquer processo do SO pelo PID
|
|
32
|
+
|
|
33
|
+
### Sistema & Segurança
|
|
34
|
+
- `get_config` — Exibe configurações atuais (`allowedDirectories`, `blockedCommands`, `defaultShell`)
|
|
35
|
+
- `set_config_value` — Atualiza configurações em tempo real (salvas em `config.json`)
|
|
36
|
+
- `get_system_info` — Informações do SO, memória, CPUs, usuário e diretório atual
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## Como compilar e testar
|
|
41
|
+
|
|
42
|
+
```powershell
|
|
43
|
+
npm install
|
|
44
|
+
npm run build
|
|
45
|
+
npm test
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## 1. Conectar no Claude Desktop (local via `stdio`)
|
|
51
|
+
|
|
52
|
+
Abra o arquivo de configuração do Claude Desktop:
|
|
53
|
+
`%APPDATA%\Claude\claude_desktop_config.json`
|
|
54
|
+
|
|
55
|
+
Adicione o bloco abaixo e reinicie o Claude Desktop:
|
|
56
|
+
|
|
57
|
+
```json
|
|
58
|
+
{
|
|
59
|
+
"mcpServers": {
|
|
60
|
+
"ide-commander": {
|
|
61
|
+
"command": "node",
|
|
62
|
+
"args": ["C:/Users/lagrima/Desktop/mcp/dist/index.js", "--stdio"]
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
> **Dica:** Esse mesmo bloco funciona também no **Cursor**, **Windsurf**, **Claude Code** e **Antigravity**.
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## 2. Conectar no ChatGPT (remoto via Streamable HTTP + Túnel HTTPS)
|
|
73
|
+
|
|
74
|
+
Como o ChatGPT roda na nuvem da OpenAI, ele precisa de uma URL **HTTPS pública** apontando para o nosso servidor HTTP (`/mcp`).
|
|
75
|
+
|
|
76
|
+
### Passo A — Inicie o servidor MCP em modo HTTP com senha (`MCP_API_KEY`)
|
|
77
|
+
|
|
78
|
+
```powershell
|
|
79
|
+
$env:MCP_API_KEY="troque-por-uma-senha-forte"
|
|
80
|
+
npm run start:http
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Endpoints disponíveis localmente:
|
|
84
|
+
- **Streamable HTTP (recomendado):** `http://127.0.0.1:3333/mcp`
|
|
85
|
+
- **Legacy SSE:** `http://127.0.0.1:3333/sse`
|
|
86
|
+
- **Health Check:** `http://127.0.0.1:3333/health`
|
|
87
|
+
|
|
88
|
+
### Passo B — Exponha em HTTPS com Cloudflare Tunnel ou ngrok
|
|
89
|
+
|
|
90
|
+
Com **Cloudflare Tunnel** (gratuito, sem conta obrigatória):
|
|
91
|
+
```powershell
|
|
92
|
+
cloudflared tunnel --url http://localhost:3333
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
Ou com **ngrok**:
|
|
96
|
+
```powershell
|
|
97
|
+
ngrok http 3333
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
Copie a URL HTTPS gerada (ex.: `https://xxxx.trycloudflare.com`) e adicione `/mcp` no final:
|
|
101
|
+
`https://xxxx.trycloudflare.com/mcp`
|
|
102
|
+
|
|
103
|
+
*(Se precisar passar a chave na URL para clientes sem suporte a header Bearer, use `?api_key=sua-senha-forte` ou configure o header `Authorization: Bearer sua-senha-forte`.)*
|
|
104
|
+
|
|
105
|
+
### Passo C — Adicione no ChatGPT
|
|
106
|
+
1. Abra o **ChatGPT** (`chatgpt.com`) → **Configurações / Apps & Connectors** (ou Plugins/MCP).
|
|
107
|
+
2. Clique em **Add custom MCP server**.
|
|
108
|
+
3. Informe:
|
|
109
|
+
- **Name:** `IDE Commander`
|
|
110
|
+
- **URL:** `https://xxxx.trycloudflare.com/mcp`
|
|
111
|
+
- **Authentication:** configure Bearer Token ou a URL com `?api_key=...` conforme o plano/UI.
|
|
112
|
+
4. Salve, ative e comece a pedir para o ChatGPT criar/editar arquivos e rodar comandos no seu PC!
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## Segurança (`config.json` e `audit.log`)
|
|
117
|
+
|
|
118
|
+
- **`allowedDirectories`**: por padrão vazio (`[]`, acesso livre). Para restringir a IA apenas às suas pastas de projeto, edite `config.json`:
|
|
119
|
+
```json
|
|
120
|
+
"allowedDirectories": ["C:\\Users\\lagrima\\Desktop", "C:\\Projetos"]
|
|
121
|
+
```
|
|
122
|
+
- **`blockedCommands`**: bloqueia comandos destrutivos (`rm -rf /`, `format c:`, `shutdown`, etc.).
|
|
123
|
+
- **`audit.log`**: registra todas as chamadas de ferramentas com data/hora e parâmetros (rotação automática em 10 MB).
|
|
124
|
+
- **Nunca exponha o servidor `--http` na internet sem definir `MCP_API_KEY`!**
|
package/bin/agent-cli.js
ADDED
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import os from "node:os";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
import fs from "node:fs";
|
|
5
|
+
import { exec } from "node:child_process";
|
|
6
|
+
import { WebSocket } from "ws";
|
|
7
|
+
|
|
8
|
+
// Abre o navegador com suporte a Windows, macOS e Linux
|
|
9
|
+
function openBrowser(url) {
|
|
10
|
+
const start =
|
|
11
|
+
process.platform === "win32"
|
|
12
|
+
? "start"
|
|
13
|
+
: process.platform === "darwin"
|
|
14
|
+
? "open"
|
|
15
|
+
: "xdg-open";
|
|
16
|
+
try {
|
|
17
|
+
exec(`${start} ${url}`);
|
|
18
|
+
} catch {
|
|
19
|
+
// Se não puder abrir automaticamente, o link fica no terminal
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
// Configuração do Hub
|
|
24
|
+
let hubHost = "https://mcp.zentrix.sbs";
|
|
25
|
+
let webHub = "https://hub.zentrix.sbs";
|
|
26
|
+
|
|
27
|
+
for (let i = 2; i < process.argv.length; i++) {
|
|
28
|
+
if (process.argv[i] === "--server" && process.argv[i + 1]) {
|
|
29
|
+
hubHost = process.argv[i + 1].trim();
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
// Arquivo local de persistência para lembrar o código da máquina
|
|
34
|
+
const CONFIG_FILE = path.join(os.homedir(), ".zentrix-mcp.json");
|
|
35
|
+
let savedConfig = {};
|
|
36
|
+
try {
|
|
37
|
+
if (fs.existsSync(CONFIG_FILE)) {
|
|
38
|
+
savedConfig = JSON.parse(fs.readFileSync(CONFIG_FILE, "utf-8"));
|
|
39
|
+
}
|
|
40
|
+
} catch {}
|
|
41
|
+
|
|
42
|
+
// Gera ou recupera código
|
|
43
|
+
function generateCode() {
|
|
44
|
+
const randNum = Math.floor(1000 + Math.random() * 9000);
|
|
45
|
+
return `ZTX-${randNum}`;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
const linkCode = (process.argv[2] || savedConfig.linkCode || generateCode()).toUpperCase();
|
|
49
|
+
|
|
50
|
+
// Salva localmente
|
|
51
|
+
try {
|
|
52
|
+
fs.writeFileSync(CONFIG_FILE, JSON.stringify({ linkCode }), "utf-8");
|
|
53
|
+
} catch {}
|
|
54
|
+
|
|
55
|
+
const linkUrl = `${webHub}?link=${linkCode}`;
|
|
56
|
+
const wsUrl = hubHost.replace(/^http/, "ws") + `/agent?code=${linkCode}`;
|
|
57
|
+
|
|
58
|
+
console.clear ? console.clear() : null;
|
|
59
|
+
console.log("");
|
|
60
|
+
console.log("=================================================================");
|
|
61
|
+
console.log(" ZENTRIX MCP AGENT • VINCULAÇÃO DIRETA ");
|
|
62
|
+
console.log("=================================================================");
|
|
63
|
+
console.log("");
|
|
64
|
+
console.log(` > Codigo da sua maquina: \x1b[1m\x1b[36m${linkCode}\x1b[0m`);
|
|
65
|
+
console.log(` > Abrindo o seu painel: \x1b[4m${linkUrl}\x1b[0m`);
|
|
66
|
+
console.log("");
|
|
67
|
+
console.log(" Aguarde... Conectando e registrando seu computador no servidor.");
|
|
68
|
+
console.log("=================================================================");
|
|
69
|
+
console.log("");
|
|
70
|
+
|
|
71
|
+
// Redireciona / abre o navegador automaticamente na URL já com o código vinculado
|
|
72
|
+
openBrowser(linkUrl);
|
|
73
|
+
|
|
74
|
+
function getSpecs() {
|
|
75
|
+
return {
|
|
76
|
+
machine_name: os.hostname(),
|
|
77
|
+
username: os.userInfo().username,
|
|
78
|
+
platform: process.platform,
|
|
79
|
+
arch: process.arch,
|
|
80
|
+
cpus: os.cpus().length,
|
|
81
|
+
total_memory_gb: Number((os.totalmem() / 1024 ** 3).toFixed(2)),
|
|
82
|
+
free_memory_gb: Number((os.freemem() / 1024 ** 3).toFixed(2)),
|
|
83
|
+
cwd: process.cwd(),
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
let ws;
|
|
88
|
+
let pingInterval;
|
|
89
|
+
|
|
90
|
+
function connect() {
|
|
91
|
+
ws = new WebSocket(wsUrl);
|
|
92
|
+
|
|
93
|
+
ws.on("open", () => {
|
|
94
|
+
console.log(`\x1b[32m[OK] Computador "${os.hostname()}" conectado e vinculado ao painel!\x1b[0m`);
|
|
95
|
+
console.log(`[Info] Todas as ferramentas MCP executarao nesta maquina.`);
|
|
96
|
+
|
|
97
|
+
ws.send(
|
|
98
|
+
JSON.stringify({
|
|
99
|
+
type: "register",
|
|
100
|
+
code: linkCode,
|
|
101
|
+
specs: getSpecs(),
|
|
102
|
+
})
|
|
103
|
+
);
|
|
104
|
+
|
|
105
|
+
pingInterval = setInterval(() => {
|
|
106
|
+
if (ws.readyState === WebSocket.OPEN) {
|
|
107
|
+
ws.send(
|
|
108
|
+
JSON.stringify({
|
|
109
|
+
type: "heartbeat",
|
|
110
|
+
code: linkCode,
|
|
111
|
+
free_memory_gb: Number((os.freemem() / 1024 ** 3).toFixed(2)),
|
|
112
|
+
})
|
|
113
|
+
);
|
|
114
|
+
}
|
|
115
|
+
}, 5000);
|
|
116
|
+
});
|
|
117
|
+
|
|
118
|
+
ws.on("message", (data) => {
|
|
119
|
+
try {
|
|
120
|
+
const msg = JSON.parse(data.toString());
|
|
121
|
+
if (msg.type === "registered") {
|
|
122
|
+
console.log(`\x1b[36m[Sync] Sincronizado com o banco de dados da VPS/SQLite.\x1b[0m`);
|
|
123
|
+
}
|
|
124
|
+
} catch {}
|
|
125
|
+
});
|
|
126
|
+
|
|
127
|
+
ws.on("close", () => {
|
|
128
|
+
clearInterval(pingInterval);
|
|
129
|
+
console.log(`[Reconexao] Conexao perdida. Tentando novamente em 4s...`);
|
|
130
|
+
setTimeout(connect, 4000);
|
|
131
|
+
});
|
|
132
|
+
|
|
133
|
+
ws.on("error", (err) => {
|
|
134
|
+
// Tratamento de erro silencioso / retry
|
|
135
|
+
});
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
connect();
|
package/package.json
CHANGED
|
@@ -1,6 +1,27 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "zentrix-mcp",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Zentrix MCP Desktop Agent - Conecte seu computador local ao ChatGPT, Claude e ao Zentrix Hub",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"bin": {
|
|
7
|
+
"zentrix-mcp": "bin/agent-cli.js"
|
|
8
|
+
},
|
|
9
|
+
"main": "bin/agent-cli.js",
|
|
10
|
+
"files": [
|
|
11
|
+
"bin",
|
|
12
|
+
"README.md"
|
|
13
|
+
],
|
|
14
|
+
"keywords": [
|
|
15
|
+
"mcp",
|
|
16
|
+
"model-context-protocol",
|
|
17
|
+
"chatgpt",
|
|
18
|
+
"claude",
|
|
19
|
+
"zentrix",
|
|
20
|
+
"desktop-commander"
|
|
21
|
+
],
|
|
22
|
+
"author": "menorzin111k",
|
|
23
|
+
"license": "MIT",
|
|
24
|
+
"dependencies": {
|
|
25
|
+
"ws": "^8.18.0"
|
|
26
|
+
}
|
|
6
27
|
}
|