thachvd-kit 1.0.20 → 1.0.21

package/.agent/docs/tooling.md

@@ -23,6 +23,12 @@ args = ["-y", "@upstash/context7-mcp"]
 startup_timeout_sec = 20
 tool_timeout_sec = 120
 
+[mcp_servers.filesystem]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-filesystem", "<projectPath>"]
+startup_timeout_sec = 20
+tool_timeout_sec = 120
+
 [mcp_servers.playwright]
 command = "npx"
 args = ["-y", "@playwright/mcp"]
@@ -67,6 +73,10 @@ Gemini CLI / Antigravity `mcp_config.json` example:
       "command": "npx",
       "args": ["-y", "@upstash/context7-mcp"]
     },
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
+    },
     "playwright": {
       "command": "npx",
       "args": ["-y", "@playwright/mcp"]
@@ -91,6 +101,16 @@ Claude Code user config example:
       "command": "codegraph",
       "args": ["serve", "--mcp"]
     },
+    "context7": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "filesystem": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
+    },
     "playwright": {
       "type": "stdio",
       "command": "npx",
@@ -102,7 +122,7 @@ Claude Code user config example:
 
 Common local path:
 
-- Claude Code: `~/.claude.json`
+- Claude Code: `~/.claude.json` or `~/.claude/settings.json`
 
 The shared kit skills live in `.agent/skills/`. Antigravity reads that folder directly. Codex shows skills from `~/.codex/skills/` in the `$` menu. Claude Code reads project skills from `.claude/skills/`.
 

package/bin/cli.js

@@ -1208,6 +1208,12 @@ args = ["-y", "@upstash/context7-mcp"]
 startup_timeout_sec = 20
 tool_timeout_sec = 120
 
+[mcp_servers.filesystem]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-filesystem", "<projectPath>"]
+startup_timeout_sec = 20
+tool_timeout_sec = 120
+
 [mcp_servers.playwright]
 command = "npx"
 args = ["-y", "@playwright/mcp"]
@@ -1252,6 +1258,10 @@ Gemini CLI / Antigravity \`mcp_config.json\` example:
       "command": "npx",
       "args": ["-y", "@upstash/context7-mcp"]
     },
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
+    },
     "playwright": {
       "command": "npx",
       "args": ["-y", "@playwright/mcp"]
@@ -1276,6 +1286,16 @@ Claude Code user config example:
       "command": "codegraph",
       "args": ["serve", "--mcp"]
     },
+    "context7": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "filesystem": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
+    },
     "playwright": {
       "type": "stdio",
       "command": "npx",
@@ -1287,7 +1307,7 @@ Claude Code user config example:
 
 Common local path:
 
-- Claude Code: \`~/.claude.json\`
+- Claude Code: \`~/.claude.json\` or \`~/.claude/settings.json\`
 
 ## Native Skill Folders
 
@@ -1446,7 +1466,7 @@ function writeJsonFile(filePath, data) {
     fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf8');
 }
 
-function mergeMcpJson(filePath, withType = false, includeContext7 = false) {
+function mergeMcpJson(filePath, withType = false) {
     const data = readJsonFile(filePath);
     if (data === null) {
         return { ok: false, message: `${filePath} is not valid JSON; skipped` };
@@ -1454,14 +1474,49 @@ function mergeMcpJson(filePath, withType = false, includeContext7 = false) {
     data.mcpServers = data.mcpServers || {};
     const baseServers = {
         codegraph: { command: 'codegraph', args: ['serve', '--mcp'] },
-        playwright: { command: 'npx', args: ['-y', '@playwright/mcp'] }
+        playwright: { command: 'npx', args: ['-y', '@playwright/mcp'] },
+        context7: { command: 'npx', args: ['-y', '@upstash/context7-mcp'] },
+        filesystem: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', targetDir.replace(/\\/g, '/')] }
     };
-    if (includeContext7) {
-        baseServers.context7 = { command: 'npx', args: ['-y', '@upstash/context7-mcp'] };
+    if (data.permissions && Array.isArray(data.permissions.allow)) {
+        const requiredPermissions = [
+            "mcp__filesystem__read_file",
+            "mcp__filesystem__read_multiple_files",
+            "mcp__filesystem__list_directory",
+            "mcp__filesystem__directory_tree",
+            "mcp__filesystem__search_files",
+            "mcp__filesystem__get_file_info",
+            "mcp__filesystem__write_file",
+            "mcp__context7__resolve-library-id",
+            "mcp__context7__query-docs"
+        ];
+        for (const perm of requiredPermissions) {
+            if (!data.permissions.allow.includes(perm)) {
+                data.permissions.allow.push(perm);
+            }
+        }
     }
     for (const [name, server] of Object.entries(baseServers)) {
         if (!data.mcpServers[name]) {
             data.mcpServers[name] = withType ? { type: 'stdio', ...server } : server;
+        } else if (name === 'filesystem') {
+            const fsServer = data.mcpServers[name];
+            if (fsServer && Array.isArray(fsServer.args)) {
+                // If it points to non-existent AppData roaming file, fix it to use npx
+                const isLegacyNode = fsServer.command === 'node' && fsServer.args[0] && fsServer.args[0].includes('server-filesystem');
+                if (isLegacyNode) {
+                    fsServer.command = 'npx';
+                    fsServer.args[0] = '-y';
+                    fsServer.args.splice(1, 0, '@modelcontextprotocol/server-filesystem');
+                }
+                const normalizedTarget = targetDir.replace(/\\/g, '/');
+                const hasTarget = fsServer.args.some(arg => {
+                    return typeof arg === 'string' && (arg.replace(/\\/g, '/').toLowerCase() === normalizedTarget.toLowerCase());
+                });
+                if (!hasTarget) {
+                    fsServer.args.push(normalizedTarget);
+                }
+            }
         }
     }
     writeJsonFile(filePath, data);
@@ -1473,12 +1528,21 @@ function appendMcpTomlIfMissing(filePath) {
     fs.mkdirSync(path.dirname(filePath), { recursive: true });
     const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : '';
     const blocks = [];
+    const normalizedTarget = targetDir.replace(/\\/g, '/');
     if (!/\[mcp_servers\.context7\]/.test(existing)) {
         blocks.push(`[mcp_servers.context7]
 command = "npx"
 args = ["-y", "@upstash/context7-mcp"]
 startup_timeout_sec = 20
 tool_timeout_sec = 120
+`);
+    }
+    if (!/\[mcp_servers\.filesystem\]/.test(existing)) {
+        blocks.push(`[mcp_servers.filesystem]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-filesystem", "${normalizedTarget}"]
+startup_timeout_sec = 20
+tool_timeout_sec = 120
 `);
     }
     if (!/\[mcp_servers\.codegraph\]/.test(existing)) {
@@ -1502,7 +1566,7 @@ tool_timeout_sec = 120
     }
     const separator = existing && !existing.endsWith('\n') ? '\n\n' : existing ? '\n' : '';
     fs.writeFileSync(filePath, existing + separator + blocks.join('\n'), 'utf8');
-    return { ok: true, message: `configured context7, codegraph, playwright MCP in ${filePath}` };
+    return { ok: true, message: `configured context7, filesystem, codegraph, playwright MCP in ${filePath}` };
 }
 
 function setupMcpServers() {
@@ -1513,19 +1577,22 @@ function setupMcpServers() {
     if (codexConfig) results.push(appendMcpTomlIfMissing(codexConfig));
 
     const geminiConfig = homePath('.gemini', 'config', 'mcp_config.json');
-    if (geminiConfig) results.push(mergeMcpJson(geminiConfig, false, true));
+    if (geminiConfig) results.push(mergeMcpJson(geminiConfig, false));
 
     const antigravityIdeConfig = homePath('.gemini', 'antigravity-ide', 'mcp_config.json');
-    if (antigravityIdeConfig) results.push(mergeMcpJson(antigravityIdeConfig, false, true));
+    if (antigravityIdeConfig) results.push(mergeMcpJson(antigravityIdeConfig, false));
 
     const antigravityConfig = homePath('.gemini', 'antigravity', 'mcp_config.json');
     if (antigravityConfig && fs.existsSync(path.dirname(antigravityConfig))) {
-        results.push(mergeMcpJson(antigravityConfig, false, true));
+        results.push(mergeMcpJson(antigravityConfig, false));
     }
 
     const claudeConfig = homePath('.claude.json');
     if (claudeConfig) results.push(mergeMcpJson(claudeConfig, true));
 
+    const claudeSettings = homePath('.claude', 'settings.json');
+    if (claudeSettings) results.push(mergeMcpJson(claudeSettings, true));
+
     return results;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "thachvd-kit",
-    "version": "1.0.20",
+    "version": "1.0.21",
     "description": "Cross-agent project rules bootstrap kit for Codex, Antigravity, and Claude Code",
     "bin": {
         "thachvd-kit": "./bin/cli.js"