@musashishao/agent-kit 1.2.2

package/.agent/mcp/servers/agent-kit-fs/src/index.ts

@@ -0,0 +1,399 @@
+#!/usr/bin/env node
+/**
+ * Agent Kit Filesystem MCP Server
+ * 
+ * Provides file system operations for AI assistants.
+ * Security: All operations are restricted to project directory.
+ * 
+ * Tools:
+ * - read_file: Read file content
+ * - list_directory: List folder contents
+ * - search_files: Find files by pattern
+ * - project_tree: Generate project tree
+ * - file_stats: Get file metadata
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import * as fs from "fs";
+import * as path from "path";
+
+const PROJECT_ROOT = process.cwd();
+const MAX_FILE_SIZE = 1024 * 1024; // 1MB
+const MAX_TREE_DEPTH = 5;
+
+const server = new McpServer({
+    name: "agent-kit-fs",
+    version: "1.0.0",
+});
+
+// ============================================================================
+// Security Helper
+// ============================================================================
+
+function isPathSafe(targetPath: string): boolean {
+    const resolved = path.resolve(PROJECT_ROOT, targetPath);
+    return resolved.startsWith(PROJECT_ROOT);
+}
+
+function resolveSafePath(targetPath: string): string | null {
+    const resolved = path.resolve(PROJECT_ROOT, targetPath);
+    if (!resolved.startsWith(PROJECT_ROOT)) {
+        return null;
+    }
+    return resolved;
+}
+
+// ============================================================================
+// Tool: read_file
+// ============================================================================
+
+server.tool(
+    "read_file",
+    "Read the contents of a file. Restricted to project directory for security.",
+    {
+        path: z.string().describe("Relative path to the file from project root"),
+        maxLines: z.number().optional().describe("Maximum lines to read (default: 500)"),
+    },
+    async ({ path: filePath, maxLines = 500 }) => {
+        const safePath = resolveSafePath(filePath);
+
+        if (!safePath) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Access denied: Path outside project directory" }),
+                }],
+            };
+        }
+
+        if (!fs.existsSync(safePath)) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: `File not found: ${filePath}` }),
+                }],
+            };
+        }
+
+        const stats = fs.statSync(safePath);
+
+        if (stats.isDirectory()) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Path is a directory, not a file" }),
+                }],
+            };
+        }
+
+        if (stats.size > MAX_FILE_SIZE) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        error: `File too large (${(stats.size / 1024 / 1024).toFixed(2)}MB). Max: 1MB`,
+                        size: stats.size,
+                    }),
+                }],
+            };
+        }
+
+        try {
+            const content = fs.readFileSync(safePath, "utf-8");
+            const lines = content.split("\n");
+            const truncated = lines.length > maxLines;
+            const output = truncated ? lines.slice(0, maxLines).join("\n") : content;
+
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        path: filePath,
+                        content: output,
+                        totalLines: lines.length,
+                        truncated,
+                        size: stats.size,
+                    }),
+                }],
+            };
+        } catch (error) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: `Failed to read file: ${error}` }),
+                }],
+            };
+        }
+    }
+);
+
+// ============================================================================
+// Tool: list_directory
+// ============================================================================
+
+server.tool(
+    "list_directory",
+    "List contents of a directory with file types and sizes",
+    {
+        path: z.string().optional().describe("Relative path to directory (default: project root)"),
+        showHidden: z.boolean().optional().describe("Include hidden files (default: false)"),
+    },
+    async ({ path: dirPath = ".", showHidden = false }) => {
+        const safePath = resolveSafePath(dirPath);
+
+        if (!safePath) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Access denied: Path outside project directory" }),
+                }],
+            };
+        }
+
+        if (!fs.existsSync(safePath) || !fs.statSync(safePath).isDirectory()) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Directory not found" }),
+                }],
+            };
+        }
+
+        try {
+            const items = fs.readdirSync(safePath);
+            const contents: Array<{
+                name: string;
+                type: "file" | "directory";
+                size?: number;
+            }> = [];
+
+            for (const item of items) {
+                if (!showHidden && item.startsWith(".")) continue;
+
+                const itemPath = path.join(safePath, item);
+                const stats = fs.statSync(itemPath);
+
+                contents.push({
+                    name: item,
+                    type: stats.isDirectory() ? "directory" : "file",
+                    size: stats.isFile() ? stats.size : undefined,
+                });
+            }
+
+            // Sort: directories first, then files
+            contents.sort((a, b) => {
+                if (a.type !== b.type) return a.type === "directory" ? -1 : 1;
+                return a.name.localeCompare(b.name);
+            });
+
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        path: dirPath,
+                        contents,
+                        count: contents.length,
+                    }, null, 2),
+                }],
+            };
+        } catch (error) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: `Failed to list directory: ${error}` }),
+                }],
+            };
+        }
+    }
+);
+
+// ============================================================================
+// Tool: search_files
+// ============================================================================
+
+server.tool(
+    "search_files",
+    "Search for files matching a pattern (supports glob patterns)",
+    {
+        pattern: z.string().describe("Search pattern (e.g., '*.ts', 'src/**/*.tsx')"),
+        maxResults: z.number().optional().describe("Maximum results (default: 50)"),
+    },
+    async ({ pattern, maxResults = 50 }) => {
+        try {
+            const { glob } = await import("glob");
+
+            const files = await glob(pattern, {
+                cwd: PROJECT_ROOT,
+                nodir: true,
+                ignore: ["**/node_modules/**", "**/.git/**", "**/dist/**", "**/build/**"],
+                maxDepth: 10,
+            });
+
+            const results = files.slice(0, maxResults).map(file => ({
+                path: file,
+                extension: path.extname(file),
+            }));
+
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        pattern,
+                        results,
+                        count: results.length,
+                        totalMatches: files.length,
+                        truncated: files.length > maxResults,
+                    }, null, 2),
+                }],
+            };
+        } catch (error) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: `Search failed: ${error}` }),
+                }],
+            };
+        }
+    }
+);
+
+// ============================================================================
+// Tool: project_tree
+// ============================================================================
+
+server.tool(
+    "project_tree",
+    "Generate a tree view of the project structure",
+    {
+        path: z.string().optional().describe("Starting path (default: project root)"),
+        maxDepth: z.number().optional().describe("Maximum depth (default: 3, max: 5)"),
+    },
+    async ({ path: startPath = ".", maxDepth = 3 }) => {
+        const safePath = resolveSafePath(startPath);
+
+        if (!safePath) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Access denied" }),
+                }],
+            };
+        }
+
+        const effectiveDepth = Math.min(maxDepth, MAX_TREE_DEPTH);
+        const ignoreDirs = new Set(["node_modules", ".git", "dist", "build", ".next", "__pycache__"]);
+
+        function buildTree(dir: string, prefix: string, depth: number): string[] {
+            if (depth > effectiveDepth) return [];
+
+            const lines: string[] = [];
+
+            try {
+                const items = fs.readdirSync(dir).filter(item => !item.startsWith(".") || item === ".agent");
+
+                items.forEach((item, index) => {
+                    const itemPath = path.join(dir, item);
+                    const isLast = index === items.length - 1;
+                    const connector = isLast ? "└── " : "├── ";
+                    const stats = fs.statSync(itemPath);
+
+                    if (stats.isDirectory()) {
+                        if (ignoreDirs.has(item)) {
+                            lines.push(`${prefix}${connector}${item}/ (ignored)`);
+                        } else {
+                            lines.push(`${prefix}${connector}${item}/`);
+                            const newPrefix = prefix + (isLast ? "    " : "│   ");
+                            lines.push(...buildTree(itemPath, newPrefix, depth + 1));
+                        }
+                    } else {
+                        lines.push(`${prefix}${connector}${item}`);
+                    }
+                });
+            } catch {
+                // Ignore permission errors
+            }
+
+            return lines;
+        }
+
+        const tree = buildTree(safePath, "", 0);
+        const treeName = startPath === "." ? path.basename(PROJECT_ROOT) : startPath;
+
+        return {
+            content: [{
+                type: "text",
+                text: `${treeName}/\n${tree.join("\n")}`,
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: file_stats
+// ============================================================================
+
+server.tool(
+    "file_stats",
+    "Get metadata about a file or directory",
+    {
+        path: z.string().describe("Path to file or directory"),
+    },
+    async ({ path: targetPath }) => {
+        const safePath = resolveSafePath(targetPath);
+
+        if (!safePath) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Access denied" }),
+                }],
+            };
+        }
+
+        if (!fs.existsSync(safePath)) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Path not found" }),
+                }],
+            };
+        }
+
+        const stats = fs.statSync(safePath);
+
+        return {
+            content: [{
+                type: "text",
+                text: JSON.stringify({
+                    path: targetPath,
+                    type: stats.isDirectory() ? "directory" : "file",
+                    size: stats.size,
+                    sizeHuman: stats.size < 1024
+                        ? `${stats.size} B`
+                        : stats.size < 1024 * 1024
+                            ? `${(stats.size / 1024).toFixed(1)} KB`
+                            : `${(stats.size / 1024 / 1024).toFixed(2)} MB`,
+                    created: stats.birthtime.toISOString(),
+                    modified: stats.mtime.toISOString(),
+                }, null, 2),
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Start Server
+// ============================================================================
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Agent Kit Filesystem MCP Server running on stdio");
+}
+
+main().catch((error) => {
+    console.error("Failed to start MCP server:", error);
+    process.exit(1);
+});

package/.agent/mcp/servers/agent-kit-fs/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/.agent/mcp/servers/agent-kit-git/package.json

@@ -0,0 +1,24 @@
+{
+    "name": "agent-kit-git",
+    "version": "1.0.0",
+    "description": "MCP server for Git operations",
+    "type": "module",
+    "main": "dist/index.js",
+    "bin": {
+        "agent-kit-git": "./dist/index.js"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsx src/index.ts",
+        "start": "node dist/index.js"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.0.0",
+        "zod": "^3.23.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.0.0",
+        "tsx": "^4.0.0",
+        "typescript": "^5.0.0"
+    }
+}