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.
Files changed (3) hide show
  1. package/README.md +123 -2
  2. package/bin/agent-cli.js +138 -0
  3. package/package.json +24 -3
package/README.md CHANGED
@@ -1,3 +1,124 @@
1
- # Temporary Holding Version
1
+ # IDE Commander MCP
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
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`!**
@@ -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": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
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
  }