@justmpm/memory 0.2.2 → 0.3.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 (9) hide show
  1. package/AGENTS.md +4 -4
  2. package/CLAUDE.md +4 -4
  3. package/dist/index.js +74 -63
  4. package/package.json +4 -4
  5. package/dist/index.d.ts.map +0 -1
  6. package/dist/index.js.map +0 -1
  7. package/mcp-config.example.json +0 -10
  8. package/src/index.ts +0 -538
  9. package/tsconfig.json +0 -20
package/AGENTS.md CHANGED
@@ -17,7 +17,7 @@ Lê todo o conteúdo da sua memória persistente.
17
17
 
18
18
  ```json
19
19
  {
20
- "agent": "seu-nome" // opcional, padrão: "unknown"
20
+ "agent": "seu-nome" // OBRIGATÓRIO
21
21
  }
22
22
  ```
23
23
 
@@ -28,7 +28,7 @@ Adiciona uma entrada no final da sua memória com timestamp automático.
28
28
 
29
29
  ```json
30
30
  {
31
- "agent": "seu-nome", // opcional
31
+ "agent": "seu-nome", // OBRIGATÓRIO
32
32
  "entry": "texto aqui" // OBRIGATÓRIO
33
33
  }
34
34
  ```
@@ -40,7 +40,7 @@ Busca um termo na sua memória sem precisar ler tudo.
40
40
 
41
41
  ```json
42
42
  {
43
- "agent": "seu-nome", // opcional
43
+ "agent": "seu-nome", // OBRIGATÓRIO
44
44
  "query": "termo" // OBRIGATÓRIO
45
45
  }
46
46
  ```
@@ -52,7 +52,7 @@ SUBSTITUI TODO o conteúdo da sua memória. **APAGA tudo o que estava antes.**
52
52
 
53
53
  ```json
54
54
  {
55
- "agent": "seu-nome", // opcional
55
+ "agent": "seu-nome", // OBRIGATÓRIO
56
56
  "content": "# Memória\\n\\n- item", // OBRIGATÓRIO
57
57
  "backup": true // opcional, cria backup antes
58
58
  }
package/CLAUDE.md CHANGED
@@ -49,7 +49,7 @@
49
49
  **Sintaxe:**
50
50
  ```json
51
51
  {
52
- "agent": "nexus" // ← Seu nome de agent (opcional, padrão: "unknown")
52
+ "agent": "nexus" // ← Seu nome de agent (OBRIGATÓRIO)
53
53
  }
54
54
  ```
55
55
 
@@ -79,7 +79,7 @@
79
79
  **Sintaxe:**
80
80
  ```json
81
81
  {
82
- "agent": "nexus",
82
+ "agent": "nexus", // ← OBRIGATÓRIO
83
83
  "entry": "Padrão descoberto: Sempre use Zod para validar inputs do usuário em todos os componentes de formulário"
84
84
  }
85
85
  ```
@@ -136,7 +136,7 @@
136
136
  **Sintaxe:**
137
137
  ```json
138
138
  {
139
- "agent": "nexus",
139
+ "agent": "nexus", // ← OBRIGATÓRIO
140
140
  "query": "Zod"
141
141
  }
142
142
  ```
@@ -178,7 +178,7 @@
178
178
  **Sintaxe:**
179
179
  ```json
180
180
  {
181
- "agent": "nexus",
181
+ "agent": "nexus", // ← OBRIGATÓRIO
182
182
  "content": "# Memória do Nexus\n\n## Padrões\n- Sempre use TypeScript estrito\n\n## Decisões\n- Zustand em vez de Redux\n\n## Bugs\n- Bug XYZ ocorre quando...",
183
183
  "backup": true
184
184
  }
package/dist/index.js CHANGED
@@ -21,27 +21,27 @@ import { z } from "zod";
21
21
  * Schema para tool memory_read
22
22
  */
23
23
  const MemoryReadSchema = z.object({
24
- agent: z.string().optional().describe('Seu nome de agent (ex: "sentinel", "fix-worker"). Opcional - usa "unknown" se não informado.'),
24
+ agent: z.string().min(1).describe('Seu nome de agent (ex: "sentinel", "fix-worker", "nexus"). OBRIGATÓRIO.'),
25
25
  });
26
26
  /**
27
27
  * Schema para tool memory_append
28
28
  */
29
29
  const MemoryAppendSchema = z.object({
30
- agent: z.string().optional().describe('Seu nome de agent (ex: "sentinel", "fix-worker"). Opcional - usa "unknown" se não informado.'),
30
+ agent: z.string().min(1).describe('Seu nome de agent (ex: "sentinel", "fix-worker", "nexus"). OBRIGATÓRIO.'),
31
31
  entry: z.string().min(1).describe('Texto da informação a salvar. Ex: "Padrão: sempre use try/catch em funções async" ou "Bug: erro quando usuário clica 2x". Será adicionado com timestamp automaticamente.'),
32
32
  });
33
33
  /**
34
34
  * Schema para tool memory_search
35
35
  */
36
36
  const MemorySearchSchema = z.object({
37
- agent: z.string().optional().describe('Seu nome de agent (ex: "sentinel", "fix-worker"). Opcional - usa "unknown" se não informado.'),
37
+ agent: z.string().min(1).describe('Seu nome de agent (ex: "sentinel", "fix-worker", "nexus"). OBRIGATÓRIO.'),
38
38
  query: z.string().min(1).describe('Palavra-chave para buscar na sua memória. Ex: "Zod", "bug", "Firebase". Retorna até 20 resultados com número da linha.'),
39
39
  });
40
40
  /**
41
41
  * Schema para tool memory_write
42
42
  */
43
43
  const MemoryWriteSchema = z.object({
44
- agent: z.string().optional().describe('Seu nome de agent (ex: "sentinel", "fix-worker"). Opcional - usa "unknown" se não informado.'),
44
+ agent: z.string().min(1).describe('Seu nome de agent (ex: "sentinel", "fix-worker", "nexus"). OBRIGATÓRIO.'),
45
45
  content: z.string().min(1).describe('Conteúdo completo em markdown para substituir a memória existente. Use para reorganizar, limpar ou reconstruir memória do zero.'),
46
46
  backup: z.boolean().optional().default(false).describe('Se true, cria um backup do conteúdo atual antes de sobrescrever. O backup é salvo como MEMORY.md.backup no mesmo diretório.'),
47
47
  });
@@ -255,15 +255,15 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
255
255
  // ────────────────────────────────────────────────────────────────────────
256
256
  {
257
257
  name: "memory_read",
258
- description: `Lê todo o conteúdo da sua memória persistente. Use sempre ao iniciar uma sessão para recuperar contexto anterior.
259
-
260
- RETORNA: Conteúdo completo do MEMORY.md localizado em .claude/agent-memory/<agent-name>/MEMORY.md.
261
-
262
- Se a memória não existir, retorna mensagem de memória vazia com sugestão para usar memory_append.
263
-
264
- Limite: Máximo 200 linhas. Ao atingir, mantém apenas as últimas 160 entradas.
265
-
266
- Parâmetro "agent": Seu nome de agent (opcional, padrão: "unknown").`,
258
+ description: `Lê todo o conteúdo da sua memória persistente. Use sempre ao iniciar uma sessão para recuperar contexto anterior.
259
+
260
+ RETORNA: Conteúdo completo do MEMORY.md localizado em .claude/agent-memory/<agent-name>/MEMORY.md.
261
+
262
+ Se a memória não existir, retorna mensagem de memória vazia com sugestão para usar memory_append.
263
+
264
+ Limite: Máximo 200 linhas. Ao atingir, mantém apenas as últimas 160 entradas.
265
+
266
+ Parâmetro "agent": Seu nome de agent (OBRIGATÓRIO).`,
267
267
  inputSchema: MemoryReadSchema,
268
268
  },
269
269
  // ────────────────────────────────────────────────────────────────────────
@@ -271,18 +271,18 @@ Parâmetro "agent": Seu nome de agent (opcional, padrão: "unknown").`,
271
271
  // ────────────────────────────────────────────────────────────────────────
272
272
  {
273
273
  name: "memory_append",
274
- description: `Adiciona uma entrada no final da sua memória com timestamp automático "## [YYYY-MM-DD HH:MM:SS]".
275
-
276
- USE QUANDO APRENDER algo importante: padrões de código, bugs recorrentes, decisões arquiteturais, preferências do usuário, configurações importantes.
277
-
278
- EXEMPLOS DE ENTRADAS VÁLIDAS:
279
- - "Padrão: Este projeto usa App Router com estrutura /features/[domain]/"
280
- - "Decisão: Escolhemos Zustand em vez de Redux porque é mais leve"
281
- - "Bug: Firestore update falha silenciosamente quando array está vazio"
282
-
283
- NÃO salve: Coisas triviais, informações temporárias, logs de conversa.
284
-
285
- Parâmetro "agent": Seu nome de agent (opcional, padrão: "unknown").
274
+ description: `Adiciona uma entrada no final da sua memória com timestamp automático "## [YYYY-MM-DD HH:MM:SS]".
275
+
276
+ USE QUANDO APRENDER algo importante: padrões de código, bugs recorrentes, decisões arquiteturais, preferências do usuário, configurações importantes.
277
+
278
+ EXEMPLOS DE ENTRADAS VÁLIDAS:
279
+ - "Padrão: Este projeto usa App Router com estrutura /features/[domain]/"
280
+ - "Decisão: Escolhemos Zustand em vez de Redux porque é mais leve"
281
+ - "Bug: Firestore update falha silenciosamente quando array está vazio"
282
+
283
+ NÃO salve: Coisas triviais, informações temporárias, logs de conversa.
284
+
285
+ Parâmetro "agent": Seu nome de agent (OBRIGATÓRIO).
286
286
  Parâmetro "entry": OBRIGATÓRIO - Texto da informação a salvar.`,
287
287
  inputSchema: MemoryAppendSchema,
288
288
  },
@@ -291,19 +291,19 @@ Parâmetro "entry": OBRIGATÓRIO - Texto da informação a salvar.`,
291
291
  // ────────────────────────────────────────────────────────────────────────
292
292
  {
293
293
  name: "memory_search",
294
- description: `Busca um termo na sua memória sem precisar ler todo o conteúdo.
295
-
296
- RETORNA: Até 20 ocorrências encontradas com número da linha. Busca case-insensitive.
297
-
298
- EXEMPLOS DE BUSCA ÚTEIS:
299
- - "Zod" → encontrar tudo sobre validação
300
- - "bug" → encontrar bugs documentados
301
- - "Firebase" → encontrar configurações
302
- - "TypeScript" → encontrar padrões de tipagem
303
-
304
- Se não encontrar, retorna mensagem de que nenhuma ocorrência foi encontrada.
305
-
306
- Parâmetro "agent": Seu nome de agent (opcional, padrão: "unknown").
294
+ description: `Busca um termo na sua memória sem precisar ler todo o conteúdo.
295
+
296
+ RETORNA: Até 20 ocorrências encontradas com número da linha. Busca case-insensitive.
297
+
298
+ EXEMPLOS DE BUSCA ÚTEIS:
299
+ - "Zod" → encontrar tudo sobre validação
300
+ - "bug" → encontrar bugs documentados
301
+ - "Firebase" → encontrar configurações
302
+ - "TypeScript" → encontrar padrões de tipagem
303
+
304
+ Se não encontrar, retorna mensagem de que nenhuma ocorrência foi encontrada.
305
+
306
+ Parâmetro "agent": Seu nome de agent (OBRIGATÓRIO).
307
307
  Parâmetro "query": OBRIGATÓRIO - Termo ou palavra-chave a buscar.`,
308
308
  inputSchema: MemorySearchSchema,
309
309
  },
@@ -312,30 +312,30 @@ Parâmetro "query": OBRIGATÓRIO - Termo ou palavra-chave a buscar.`,
312
312
  // ────────────────────────────────────────────────────────────────────────
313
313
  {
314
314
  name: "memory_write",
315
- description: `SUBSTITUI TODO o conteúdo da sua memória. APAGA tudo que estava antes - use com cautela.
316
-
317
- USE QUANDO: Memória está grande (~150+ linhas) e precisa reorganizar, ou quer remover entradas obsoletas.
318
-
319
- DICAS:
320
- - Use "backup: true" para criar MEMORY.md.backup antes de sobrescrever
321
- - Leia primeiro com memory_read para não perder conteúdo importante
322
- - Organize em seções: ## Padrões, ## Bugs, ## Decisões, ## Configurações
323
-
324
- EXEMPLO DE ESTRUTURA:
325
- # Memória do Agent
326
-
327
- ## Padrões de Código
328
- - Sempre use TypeScript estrito
329
-
330
- ## Bugs Conhecidos
331
- - Bug XYZ: ocorre quando array vazio
332
- Workaround: verificar length antes de usar
333
-
334
- ## Decisões
335
- - Zustand em vez de Redux (mais leve)
336
-
337
- Parâmetro "agent": Seu nome de agent (opcional, padrão: "unknown").
338
- Parâmetro "content": OBRIGATÓRIO - Novo conteúdo completo em markdown.
315
+ description: `SUBSTITUI TODO o conteúdo da sua memória. APAGA tudo que estava antes - use com cautela.
316
+
317
+ USE QUANDO: Memória está grande (~150+ linhas) e precisa reorganizar, ou quer remover entradas obsoletas.
318
+
319
+ DICAS:
320
+ - Use "backup: true" para criar MEMORY.md.backup antes de sobrescrever
321
+ - Leia primeiro com memory_read para não perder conteúdo importante
322
+ - Organize em seções: ## Padrões, ## Bugs, ## Decisões, ## Configurações
323
+
324
+ EXEMPLO DE ESTRUTURA:
325
+ # Memória do Agent
326
+
327
+ ## Padrões de Código
328
+ - Sempre use TypeScript estrito
329
+
330
+ ## Bugs Conhecidos
331
+ - Bug XYZ: ocorre quando array vazio
332
+ Workaround: verificar length antes de usar
333
+
334
+ ## Decisões
335
+ - Zustand em vez de Redux (mais leve)
336
+
337
+ Parâmetro "agent": Seu nome de agent (OBRIGATÓRIO).
338
+ Parâmetro "content": OBRIGATÓRIO - Novo conteúdo completo em markdown.
339
339
  Parâmetro "backup": Opcional (padrão: false) - Se true, cria backup antes de sobrescrever.`,
340
340
  inputSchema: MemoryWriteSchema,
341
341
  },
@@ -347,7 +347,18 @@ Parâmetro "backup": Opcional (padrão: false) - Se true, cria backup antes de s
347
347
  */
348
348
  server.setRequestHandler(CallToolRequestSchema, async (request) => {
349
349
  const { name, arguments: args } = request.params;
350
- const agentName = args?.agent || "unknown";
350
+ const agentName = args?.agent;
351
+ // Valida parâmetro agent obrigatório
352
+ if (!agentName || typeof agentName !== "string" || agentName.trim().length === 0) {
353
+ return {
354
+ content: [
355
+ {
356
+ type: "text",
357
+ text: `❌ Erro: Parâmetro "agent" é obrigatório em todas as operações de memória. Informe o nome do agent (ex: "sentinel", "nexus", "fix-worker").`,
358
+ },
359
+ ],
360
+ };
361
+ }
351
362
  try {
352
363
  switch (name) {
353
364
  case "memory_read": {
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
- {
2
- "name": "@justmpm/memory",
3
- "version": "0.2.2",
4
- "description": "MCP Server para gerenciar memória persistente de subagents",
1
+ {
2
+ "name": "@justmpm/memory",
3
+ "version": "0.3.0",
4
+ "description": "MCP Server para gerenciar memória persistente de subagents",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
7
  "bin": {
package/dist/index.d.ts.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}
package/dist/index.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/mcp-config.example.json DELETED
@@ -1,10 +0,0 @@
1
- {
2
- "mcpServers": {
3
- "memory": {
4
- "command": "node",
5
- "args": [
6
- "D:\\Users\\Matheus Pimenta\\Pictures\\Pacotes-Pessoais\\mcps-ai\\memory\\dist\\index.js"
7
- ]
8
- }
9
- }
10
- }
package/src/index.ts DELETED
@@ -1,538 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * Memory MCP Server - Sistema de memória persistente para subagents
5
- *
6
- * Permite que subagents salvem e recuperem aprendizados entre sessões.
7
- * Cada agent tem sua própria memória, armazenada em .claude/agent-memory/<agent-name>/MEMORY.md
8
- *
9
- * @see https://modelcontextprotocol.io/
10
- */
11
-
12
- import { Server } from "@modelcontextprotocol/sdk/server/index.js";
13
- import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
14
- import {
15
- CallToolRequestSchema,
16
- ListToolsRequestSchema,
17
- } from "@modelcontextprotocol/sdk/types.js";
18
- import {
19
- readFileSync,
20
- writeFileSync,
21
- existsSync,
22
- mkdirSync,
23
- } from "fs";
24
- import { join, dirname } from "path";
25
- import { fileURLToPath } from "url";
26
- import { z } from "zod";
27
-
28
- // ═══════════════════════════════════════════════════════════════════════════
29
- // SCHEMAS DE VALIDAÇÃO (Zod)
30
- // ═══════════════════════════════════════════════════════════════════════════
31
-
32
- /**
33
- * Schema para tool memory_read
34
- */
35
- const MemoryReadSchema = z.object({
36
- agent: z.string().optional().describe(
37
- 'Seu nome de agent (ex: "sentinel", "fix-worker"). Opcional - usa "unknown" se não informado.'
38
- ),
39
- });
40
-
41
- /**
42
- * Schema para tool memory_append
43
- */
44
- const MemoryAppendSchema = z.object({
45
- agent: z.string().optional().describe(
46
- 'Seu nome de agent (ex: "sentinel", "fix-worker"). Opcional - usa "unknown" se não informado.'
47
- ),
48
- entry: z.string().min(1).describe(
49
- 'Texto da informação a salvar. Ex: "Padrão: sempre use try/catch em funções async" ou "Bug: erro quando usuário clica 2x". Será adicionado com timestamp automaticamente.'
50
- ),
51
- });
52
-
53
- /**
54
- * Schema para tool memory_search
55
- */
56
- const MemorySearchSchema = z.object({
57
- agent: z.string().optional().describe(
58
- 'Seu nome de agent (ex: "sentinel", "fix-worker"). Opcional - usa "unknown" se não informado.'
59
- ),
60
- query: z.string().min(1).describe(
61
- 'Palavra-chave para buscar na sua memória. Ex: "Zod", "bug", "Firebase". Retorna até 20 resultados com número da linha.'
62
- ),
63
- });
64
-
65
- /**
66
- * Schema para tool memory_write
67
- */
68
- const MemoryWriteSchema = z.object({
69
- agent: z.string().optional().describe(
70
- 'Seu nome de agent (ex: "sentinel", "fix-worker"). Opcional - usa "unknown" se não informado.'
71
- ),
72
- content: z.string().min(1).describe(
73
- 'Conteúdo completo em markdown para substituir a memória existente. Use para reorganizar, limpar ou reconstruir memória do zero.'
74
- ),
75
- backup: z.boolean().optional().default(false).describe(
76
- 'Se true, cria um backup do conteúdo atual antes de sobrescrever. O backup é salvo como MEMORY.md.backup no mesmo diretório.'
77
- ),
78
- });
79
-
80
- // ═══════════════════════════════════════════════════════════════════════════
81
- // VERSÃO DO PROJETO
82
- // ═══════════════════════════════════════════════════════════════════════════
83
-
84
- /**
85
- * Lê a versão do package.json dinamicamente
86
- */
87
- function getPackageVersion(): string {
88
- try {
89
- const __filename = fileURLToPath(import.meta.url);
90
- const __dirname = dirname(__filename);
91
- const packagePath = join(__dirname, "..", "package.json");
92
- const packageJson = JSON.parse(readFileSync(packagePath, "utf-8"));
93
- return packageJson.version || "0.1.0";
94
- } catch {
95
- return "0.1.0";
96
- }
97
- }
98
-
99
- const PACKAGE_VERSION = getPackageVersion();
100
-
101
- // ═══════════════════════════════════════════════════════════════════════════
102
- // FUNÇÕES UTILITÁRIAS
103
- // ═══════════════════════════════════════════════════════════════════════════
104
-
105
- /**
106
- * Normaliza nome do agent para usar como nome de pasta
107
- * Ex: "Sentinel" → "sentinel", "QA-Tester" → "qa-tester"
108
- */
109
- function normalizeAgentName(agentName: string): string {
110
- return agentName
111
- .toLowerCase()
112
- .replace(/[^a-z0-9]+/g, "-")
113
- .replace(/^-|-$/g, "");
114
- }
115
-
116
- /**
117
- * Retorna o caminho do diretório de memória para um agent
118
- */
119
- function getAgentMemoryDir(agentName: string): string {
120
- const normalizedName = normalizeAgentName(agentName);
121
- return join(process.cwd(), ".claude", "agent-memory", normalizedName);
122
- }
123
-
124
- /**
125
- * Retorna o caminho do arquivo MEMORY.md de um agent
126
- */
127
- function getAgentMemoryPath(agentName: string): string {
128
- return join(getAgentMemoryDir(agentName), "MEMORY.md");
129
- }
130
-
131
- /**
132
- * Garante que o diretório existe
133
- */
134
- function ensureAgentMemoryDir(agentName: string): void {
135
- const dir = getAgentMemoryDir(agentName);
136
- if (!existsSync(dir)) {
137
- mkdirSync(dir, { recursive: true });
138
- }
139
- }
140
-
141
- /**
142
- * Formata timestamp para uso em entradas de memória
143
- */
144
- function formatTimestamp(): string {
145
- const now = new Date();
146
- return now.toISOString().replace("T", " ").slice(0, 19);
147
- }
148
-
149
- /**
150
- * Limita memória a ~200 linhas (últimas entradas)
151
- */
152
- function limitMemoryLines(content: string, maxLines = 200): string {
153
- const lines = content.split("\n");
154
- if (lines.length <= maxLines) return content;
155
- const keepCount = Math.floor(maxLines * 0.8); // 160 linhas
156
- const removed = lines.length - keepCount;
157
- return `# Memória (últimas ${keepCount} de ${lines.length} linhas)
158
-
159
- [... ${removed} linhas anteriores removidas ...]
160
-
161
- ${lines.slice(-keepCount).join("\n")}`;
162
- }
163
-
164
- // ═══════════════════════════════════════════════════════════════════════════
165
- // HANDLERS DAS OPERAÇÕES
166
- // ═══════════════════════════════════════════════════════════════════════════
167
-
168
- /**
169
- * Handler: read - Lê a memória do agent atual
170
- */
171
- async function handleRead(agentName: string): Promise<string> {
172
- const memoryPath = getAgentMemoryPath(agentName);
173
-
174
- if (!existsSync(memoryPath)) {
175
- return `📝 Memória vazia para agent "${agentName}".
176
-
177
- Use \`command="append", entry="..."\` para criar a primeira entrada.`;
178
- }
179
-
180
- try {
181
- const content = readFileSync(memoryPath, "utf-8");
182
- const lines = content.split("\n").length;
183
- return `📝 Memória de "${agentName}" (${lines} linhas):
184
-
185
- ─────────────────────────────────────────────────────────────────
186
-
187
- ${content}`;
188
- } catch (error) {
189
- return `❌ Erro ao ler memória: ${(error as Error).message}`;
190
- }
191
- }
192
-
193
- /**
194
- * Handler: write - Substitui toda a memória
195
- */
196
- async function handleWrite(
197
- agentName: string,
198
- content: string,
199
- backup: boolean = false
200
- ): Promise<string> {
201
- try {
202
- ensureAgentMemoryDir(agentName);
203
- const memoryPath = getAgentMemoryPath(agentName);
204
-
205
- // Cria backup se solicitado e arquivo existir
206
- let backupMessage = "";
207
- if (backup && existsSync(memoryPath)) {
208
- const backupPath = memoryPath + ".backup";
209
- const existingContent = readFileSync(memoryPath, "utf-8");
210
- writeFileSync(backupPath, existingContent, "utf-8");
211
- backupMessage = `\n💾 Backup criado: MEMORY.md.backup`;
212
- }
213
-
214
- const limited = limitMemoryLines(content);
215
- writeFileSync(memoryPath, limited, "utf-8");
216
-
217
- const lines = limited.split("\n").length;
218
- return `✅ Memória de "${agentName}" atualizada (${lines} linhas).${backupMessage}
219
-
220
- ${lines >= 200 ? "⚠️ Memória atingiu o limite de 200 linhas." : ""}`;
221
- } catch (error) {
222
- return `❌ Erro ao escrever memória: ${(error as Error).message}`;
223
- }
224
- }
225
-
226
- /**
227
- * Handler: append - Adiciona uma entrada no final
228
- */
229
- async function handleAppend(
230
- agentName: string,
231
- entry: string
232
- ): Promise<string> {
233
- try {
234
- ensureAgentMemoryDir(agentName);
235
- const memoryPath = getAgentMemoryPath(agentName);
236
-
237
- // Lê conteúdo existente
238
- let existingContent = "";
239
- if (existsSync(memoryPath)) {
240
- existingContent = readFileSync(memoryPath, "utf-8");
241
- }
242
-
243
- // Adiciona nova entrada com timestamp
244
- const timestamp = formatTimestamp();
245
- const newEntry = `\n## [${timestamp}]\n${entry}\n`;
246
- const newContent = existingContent + newEntry;
247
-
248
- // Salva com limite
249
- const limited = limitMemoryLines(newContent);
250
- writeFileSync(memoryPath, limited, "utf-8");
251
-
252
- return `✅ Entrada adicionada à memória de "${agentName}".
253
-
254
- **Timestamp:** ${timestamp}
255
- **Entry:** ${entry.slice(0, 100)}${entry.length > 100 ? "..." : ""}`;
256
- } catch (error) {
257
- return `❌ Erro ao adicionar entrada: ${(error as Error).message}`;
258
- }
259
- }
260
-
261
- /**
262
- * Handler: search - Busca texto na memória
263
- */
264
- async function handleSearch(
265
- agentName: string,
266
- query: string
267
- ): Promise<string> {
268
- const memoryPath = getAgentMemoryPath(agentName);
269
-
270
- if (!existsSync(memoryPath)) {
271
- return `📝 Memória vazia para agent "${agentName}".`;
272
- }
273
-
274
- try {
275
- const content = readFileSync(memoryPath, "utf-8");
276
- const lines = content.split("\n");
277
- const queryLower = query.toLowerCase();
278
-
279
- const matches = lines
280
- .map((line, idx) => ({ line, idx }))
281
- .filter(({ line }) => line.toLowerCase().includes(queryLower));
282
-
283
- if (matches.length === 0) {
284
- return `📝 Nenhuma ocorrência de "${query}" encontrada na memória de "${agentName}".`;
285
- }
286
-
287
- const results = matches
288
- .slice(0, 20) // Máximo 20 resultados
289
- .map(({ line, idx }) => ` L${idx + 1}: ${line}`)
290
- .join("\n");
291
-
292
- const more = matches.length > 20 ? `\n... e mais ${matches.length - 20} ocorrências` : "";
293
-
294
- return `📝 Busca por "${query}" em "${agentName}" (${matches.length} ocorrências):
295
-
296
- ${results}${more}`;
297
- } catch (error) {
298
- return `❌ Erro ao buscar: ${(error as Error).message}`;
299
- }
300
- }
301
-
302
-
303
- // ═══════════════════════════════════════════════════════════════════════════
304
- // SERVIDOR MCP
305
- // ═══════════════════════════════════════════════════════════════════════════
306
-
307
- // Cria o servidor MCP
308
- const server = new Server(
309
- {
310
- name: "@justmpm/memory",
311
- version: PACKAGE_VERSION,
312
- },
313
- {
314
- capabilities: {
315
- tools: {},
316
- },
317
- }
318
- );
319
-
320
- /**
321
- * Handler: ListTools - Lista todas as tools disponíveis
322
- */
323
- server.setRequestHandler(ListToolsRequestSchema, async () => {
324
- return {
325
- tools: [
326
- // ────────────────────────────────────────────────────────────────────────
327
- // TOOL: memory_read
328
- // ────────────────────────────────────────────────────────────────────────
329
- {
330
- name: "memory_read",
331
- description: `Lê todo o conteúdo da sua memória persistente. Use sempre ao iniciar uma sessão para recuperar contexto anterior.
332
-
333
- RETORNA: Conteúdo completo do MEMORY.md localizado em .claude/agent-memory/<agent-name>/MEMORY.md.
334
-
335
- Se a memória não existir, retorna mensagem de memória vazia com sugestão para usar memory_append.
336
-
337
- Limite: Máximo 200 linhas. Ao atingir, mantém apenas as últimas 160 entradas.
338
-
339
- Parâmetro "agent": Seu nome de agent (opcional, padrão: "unknown").`,
340
- inputSchema: MemoryReadSchema,
341
- },
342
-
343
- // ────────────────────────────────────────────────────────────────────────
344
- // TOOL: memory_append
345
- // ────────────────────────────────────────────────────────────────────────
346
- {
347
- name: "memory_append",
348
- description: `Adiciona uma entrada no final da sua memória com timestamp automático "## [YYYY-MM-DD HH:MM:SS]".
349
-
350
- USE QUANDO APRENDER algo importante: padrões de código, bugs recorrentes, decisões arquiteturais, preferências do usuário, configurações importantes.
351
-
352
- EXEMPLOS DE ENTRADAS VÁLIDAS:
353
- - "Padrão: Este projeto usa App Router com estrutura /features/[domain]/"
354
- - "Decisão: Escolhemos Zustand em vez de Redux porque é mais leve"
355
- - "Bug: Firestore update falha silenciosamente quando array está vazio"
356
-
357
- NÃO salve: Coisas triviais, informações temporárias, logs de conversa.
358
-
359
- Parâmetro "agent": Seu nome de agent (opcional, padrão: "unknown").
360
- Parâmetro "entry": OBRIGATÓRIO - Texto da informação a salvar.`,
361
- inputSchema: MemoryAppendSchema,
362
- },
363
-
364
- // ────────────────────────────────────────────────────────────────────────
365
- // TOOL: memory_search
366
- // ────────────────────────────────────────────────────────────────────────
367
- {
368
- name: "memory_search",
369
- description: `Busca um termo na sua memória sem precisar ler todo o conteúdo.
370
-
371
- RETORNA: Até 20 ocorrências encontradas com número da linha. Busca case-insensitive.
372
-
373
- EXEMPLOS DE BUSCA ÚTEIS:
374
- - "Zod" → encontrar tudo sobre validação
375
- - "bug" → encontrar bugs documentados
376
- - "Firebase" → encontrar configurações
377
- - "TypeScript" → encontrar padrões de tipagem
378
-
379
- Se não encontrar, retorna mensagem de que nenhuma ocorrência foi encontrada.
380
-
381
- Parâmetro "agent": Seu nome de agent (opcional, padrão: "unknown").
382
- Parâmetro "query": OBRIGATÓRIO - Termo ou palavra-chave a buscar.`,
383
- inputSchema: MemorySearchSchema,
384
- },
385
-
386
- // ────────────────────────────────────────────────────────────────────────
387
- // TOOL: memory_write
388
- // ────────────────────────────────────────────────────────────────────────
389
- {
390
- name: "memory_write",
391
- description: `SUBSTITUI TODO o conteúdo da sua memória. APAGA tudo que estava antes - use com cautela.
392
-
393
- USE QUANDO: Memória está grande (~150+ linhas) e precisa reorganizar, ou quer remover entradas obsoletas.
394
-
395
- DICAS:
396
- - Use "backup: true" para criar MEMORY.md.backup antes de sobrescrever
397
- - Leia primeiro com memory_read para não perder conteúdo importante
398
- - Organize em seções: ## Padrões, ## Bugs, ## Decisões, ## Configurações
399
-
400
- EXEMPLO DE ESTRUTURA:
401
- # Memória do Agent
402
-
403
- ## Padrões de Código
404
- - Sempre use TypeScript estrito
405
-
406
- ## Bugs Conhecidos
407
- - Bug XYZ: ocorre quando array vazio
408
- Workaround: verificar length antes de usar
409
-
410
- ## Decisões
411
- - Zustand em vez de Redux (mais leve)
412
-
413
- Parâmetro "agent": Seu nome de agent (opcional, padrão: "unknown").
414
- Parâmetro "content": OBRIGATÓRIO - Novo conteúdo completo em markdown.
415
- Parâmetro "backup": Opcional (padrão: false) - Se true, cria backup antes de sobrescrever.`,
416
- inputSchema: MemoryWriteSchema,
417
- },
418
- ],
419
- };
420
- });
421
-
422
- /**
423
- * Handler: CallTool - Executa uma tool
424
- */
425
- server.setRequestHandler(CallToolRequestSchema, async (request) => {
426
- const { name, arguments: args } = request.params;
427
- const agentName = (args?.agent as string) || "unknown";
428
-
429
- try {
430
- switch (name) {
431
- case "memory_read": {
432
- const parsed = MemoryReadSchema.safeParse(args);
433
- if (!parsed.success) {
434
- throw new Error(`Parâmetros inválidos: ${parsed.error.issues.map((e: { message: string }) => e.message).join(", ")}`);
435
- }
436
- const result = await handleRead(agentName);
437
- return { content: [{ type: "text", text: result }] };
438
- }
439
-
440
- case "memory_append": {
441
- const parsed = MemoryAppendSchema.safeParse(args);
442
- if (!parsed.success) {
443
- throw new Error(`Parâmetros inválidos: ${parsed.error.issues.map((e: { message: string }) => e.message).join(", ")}`);
444
- }
445
- const result = await handleAppend(agentName, parsed.data.entry);
446
- return { content: [{ type: "text", text: result }] };
447
- }
448
-
449
- case "memory_search": {
450
- const parsed = MemorySearchSchema.safeParse(args);
451
- if (!parsed.success) {
452
- throw new Error(`Parâmetros inválidos: ${parsed.error.issues.map((e: { message: string }) => e.message).join(", ")}`);
453
- }
454
- const result = await handleSearch(agentName, parsed.data.query);
455
- return { content: [{ type: "text", text: result }] };
456
- }
457
-
458
- case "memory_write": {
459
- const parsed = MemoryWriteSchema.safeParse(args);
460
- if (!parsed.success) {
461
- throw new Error(`Parâmetros inválidos: ${parsed.error.issues.map((e: { message: string }) => e.message).join(", ")}`);
462
- }
463
- const result = await handleWrite(agentName, parsed.data.content, parsed.data.backup);
464
- return { content: [{ type: "text", text: result }] };
465
- }
466
-
467
- default:
468
- throw new Error(`Tool desconhecida: ${name}`);
469
- }
470
- } catch (error) {
471
- const errorMessage = error instanceof Error ? error.message : String(error);
472
- return {
473
- content: [
474
- {
475
- type: "text",
476
- text: `❌ Erro ao executar tool "${name}": ${errorMessage}`,
477
- },
478
- ],
479
- };
480
- }
481
- });
482
-
483
- // ═══════════════════════════════════════════════════════════════════════════
484
- // INICIALIZAÇÃO
485
- // ═══════════════════════════════════════════════════════════════════════════
486
-
487
- async function main() {
488
- // Verifica argumentos de linha de comando
489
- const args = process.argv.slice(2);
490
-
491
- // --version
492
- if (args.includes("--version") || args.includes("-v")) {
493
- console.log(`@justmpm/memory v${PACKAGE_VERSION}`);
494
- process.exit(0);
495
- }
496
-
497
- // --help
498
- if (args.includes("--help") || args.includes("-h")) {
499
- console.log(`
500
- @justmpm/memory - MCP Server para gerenciar memória persistente de subagents
501
-
502
- Versão: ${PACKAGE_VERSION}
503
-
504
- USO:
505
- memory Inicia o servidor MCP (comunicação via stdio)
506
- memory --version Mostra a versão do pacote
507
- memory --help Mostra esta mensagem de ajuda
508
-
509
- TOOLS MCP:
510
- - memory_read Lê a memória de um agent
511
- - memory_write Substitui toda a memória
512
- - memory_append Adiciona uma entrada ao final
513
- - memory_search Busca texto na memória
514
-
515
- DOCUMENTAÇÃO:
516
- Para mais detalhes, consulte:
517
- - CLAUDE.md (Documentação para IAs)
518
- - AGENTS.md (Guia para subagents)
519
- - README.md (Documentação principal)
520
-
521
- REPOSITÓRIO:
522
- https://github.com/justmpm/memory-mcp
523
-
524
- LICENÇA:
525
- MIT © Koda AI Studio
526
- `);
527
- process.exit(0);
528
- }
529
-
530
- const transport = new StdioServerTransport();
531
- await server.connect(transport);
532
- // Não faz log aqui pois o servidor se comunica via stdio
533
- }
534
-
535
- main().catch((error) => {
536
- console.error("Erro fatal ao iniciar servidor:", error);
537
- process.exit(1);
538
- });
package/tsconfig.json DELETED
@@ -1,20 +0,0 @@
1
- {
2
- "compilerOptions": {
3
- "target": "ES2022",
4
- "module": "ES2022",
5
- "lib": ["ES2022"],
6
- "moduleResolution": "node",
7
- "outDir": "./dist",
8
- "rootDir": "./src",
9
- "strict": true,
10
- "esModuleInterop": true,
11
- "skipLibCheck": true,
12
- "forceConsistentCasingInFileNames": true,
13
- "resolveJsonModule": true,
14
- "declaration": true,
15
- "declarationMap": true,
16
- "sourceMap": true
17
- },
18
- "include": ["src/**/*"],
19
- "exclude": ["node_modules", "dist"]
20
- }