@musashishao/agent-kit 1.2.2

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

@@ -0,0 +1,455 @@
+#!/usr/bin/env node
+/**
+ * Agent Kit Core MCP Server
+ * 
+ * Provides tools for Agent Kit project analysis and integration.
+ * 
+ * Tools:
+ * - analyze_project: Scan project structure and tech stack
+ * - list_agents: List available agents with descriptions
+ * - list_skills: List skills by category
+ * - list_workflows: List available workflows
+ * - get_agent: Get full agent file content
+ * - get_skill: Get skill documentation
+ */
+
+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";
+
+// Get project root (where the command is run)
+const PROJECT_ROOT = process.cwd();
+const AGENT_DIR = path.join(PROJECT_ROOT, ".agent");
+
+// Create MCP server
+const server = new McpServer({
+    name: "agent-kit-core",
+    version: "1.0.0",
+});
+
+// ============================================================================
+// Helper Functions
+// ============================================================================
+
+function fileExists(filePath: string): boolean {
+    try {
+        return fs.existsSync(filePath);
+    } catch {
+        return false;
+    }
+}
+
+function readFileContent(filePath: string): string | null {
+    try {
+        return fs.readFileSync(filePath, "utf-8");
+    } catch {
+        return null;
+    }
+}
+
+function getDirectoryContents(dirPath: string): string[] {
+    try {
+        return fs.readdirSync(dirPath);
+    } catch {
+        return [];
+    }
+}
+
+function extractFrontmatter(content: string): Record<string, string> {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) return {};
+
+    const frontmatter: Record<string, string> = {};
+    const lines = match[1].split("\n");
+
+    for (const line of lines) {
+        const colonIndex = line.indexOf(":");
+        if (colonIndex > 0) {
+            const key = line.slice(0, colonIndex).trim();
+            const value = line.slice(colonIndex + 1).trim();
+            frontmatter[key] = value;
+        }
+    }
+
+    return frontmatter;
+}
+
+function detectTechStack(projectRoot: string): string[] {
+    const techStack: string[] = [];
+
+    // Check package.json
+    const packageJsonPath = path.join(projectRoot, "package.json");
+    if (fileExists(packageJsonPath)) {
+        const content = readFileContent(packageJsonPath);
+        if (content) {
+            const pkg = JSON.parse(content);
+            const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+
+            if (deps["next"]) techStack.push("Next.js");
+            if (deps["react"]) techStack.push("React");
+            if (deps["vue"]) techStack.push("Vue");
+            if (deps["express"]) techStack.push("Express");
+            if (deps["tailwindcss"]) techStack.push("Tailwind CSS");
+            if (deps["typescript"]) techStack.push("TypeScript");
+            if (deps["prisma"]) techStack.push("Prisma");
+        }
+    }
+
+    // Check for Python
+    if (fileExists(path.join(projectRoot, "requirements.txt")) ||
+        fileExists(path.join(projectRoot, "pyproject.toml"))) {
+        techStack.push("Python");
+    }
+
+    // Check for Go
+    if (fileExists(path.join(projectRoot, "go.mod"))) {
+        techStack.push("Go");
+    }
+
+    return techStack;
+}
+
+// ============================================================================
+// Tool: analyze_project
+// ============================================================================
+
+server.tool(
+    "analyze_project",
+    "Analyze the current project structure, tech stack, and Agent Kit configuration",
+    {},
+    async () => {
+        const analysis: Record<string, unknown> = {
+            projectRoot: PROJECT_ROOT,
+            agentKitInstalled: fileExists(AGENT_DIR),
+            techStack: detectTechStack(PROJECT_ROOT),
+        };
+
+        if (analysis.agentKitInstalled) {
+            const agentsDir = path.join(AGENT_DIR, "agents");
+            const skillsDir = path.join(AGENT_DIR, "skills");
+            const workflowsDir = path.join(AGENT_DIR, "workflows");
+
+            analysis.agents = getDirectoryContents(agentsDir).filter(f => f.endsWith(".md")).length;
+            analysis.skills = getDirectoryContents(skillsDir).filter(f => !f.startsWith(".")).length;
+            analysis.workflows = getDirectoryContents(workflowsDir).filter(f => f.endsWith(".md")).length;
+
+            // Check for AGENTS.md
+            analysis.hasAgentsMd = fileExists(path.join(PROJECT_ROOT, "AGENTS.md"));
+        }
+
+        // Check project structure
+        const structure: string[] = [];
+        const items = getDirectoryContents(PROJECT_ROOT);
+        for (const item of items.slice(0, 20)) {
+            if (item.startsWith(".") && !item.startsWith(".agent")) continue;
+            const stat = fs.statSync(path.join(PROJECT_ROOT, item));
+            structure.push(stat.isDirectory() ? `📁 ${item}/` : `📄 ${item}`);
+        }
+        analysis.structure = structure;
+
+        return {
+            content: [{
+                type: "text",
+                text: JSON.stringify(analysis, null, 2),
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: list_agents
+// ============================================================================
+
+server.tool(
+    "list_agents",
+    "List all available Agent Kit agents with their descriptions",
+    {},
+    async () => {
+        const agentsDir = path.join(AGENT_DIR, "agents");
+
+        if (!fileExists(agentsDir)) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Agent Kit not installed. Run: npx @musashishao/agent-kit init" }),
+                }],
+            };
+        }
+
+        const agents: Array<{ name: string; description: string }> = [];
+        const files = getDirectoryContents(agentsDir).filter(f => f.endsWith(".md"));
+
+        for (const file of files) {
+            const content = readFileContent(path.join(agentsDir, file));
+            if (content) {
+                const frontmatter = extractFrontmatter(content);
+                agents.push({
+                    name: file.replace(".md", ""),
+                    description: frontmatter.description || "No description",
+                });
+            }
+        }
+
+        return {
+            content: [{
+                type: "text",
+                text: JSON.stringify({ agents, count: agents.length }, null, 2),
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: list_skills
+// ============================================================================
+
+server.tool(
+    "list_skills",
+    "List all available Agent Kit skills organized by category",
+    {},
+    async () => {
+        const skillsDir = path.join(AGENT_DIR, "skills");
+
+        if (!fileExists(skillsDir)) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Agent Kit not installed" }),
+                }],
+            };
+        }
+
+        const skills: Array<{ name: string; description: string }> = [];
+        const directories = getDirectoryContents(skillsDir).filter(f => !f.startsWith("."));
+
+        for (const dir of directories) {
+            const skillMd = path.join(skillsDir, dir, "SKILL.md");
+            if (fileExists(skillMd)) {
+                const content = readFileContent(skillMd);
+                if (content) {
+                    const frontmatter = extractFrontmatter(content);
+                    skills.push({
+                        name: dir,
+                        description: frontmatter.description || "No description",
+                    });
+                }
+            }
+        }
+
+        // Categorize skills
+        const categories: Record<string, typeof skills> = {
+            frontend: [],
+            backend: [],
+            database: [],
+            security: [],
+            devops: [],
+            design: [],
+            other: [],
+        };
+
+        for (const skill of skills) {
+            const name = skill.name.toLowerCase();
+            if (name.includes("react") || name.includes("next") || name.includes("frontend") || name.includes("tailwind")) {
+                categories.frontend.push(skill);
+            } else if (name.includes("api") || name.includes("node") || name.includes("backend") || name.includes("nest")) {
+                categories.backend.push(skill);
+            } else if (name.includes("database") || name.includes("prisma") || name.includes("sql")) {
+                categories.database.push(skill);
+            } else if (name.includes("security") || name.includes("vulnerability") || name.includes("red-team")) {
+                categories.security.push(skill);
+            } else if (name.includes("deploy") || name.includes("docker") || name.includes("server")) {
+                categories.devops.push(skill);
+            } else if (name.includes("design") || name.includes("ui") || name.includes("ux")) {
+                categories.design.push(skill);
+            } else {
+                categories.other.push(skill);
+            }
+        }
+
+        return {
+            content: [{
+                type: "text",
+                text: JSON.stringify({ categories, totalCount: skills.length }, null, 2),
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: list_workflows
+// ============================================================================
+
+server.tool(
+    "list_workflows",
+    "List all available Agent Kit workflows (slash commands)",
+    {},
+    async () => {
+        const workflowsDir = path.join(AGENT_DIR, "workflows");
+
+        if (!fileExists(workflowsDir)) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Agent Kit not installed" }),
+                }],
+            };
+        }
+
+        const workflows: Array<{ command: string; description: string }> = [];
+        const files = getDirectoryContents(workflowsDir).filter(f => f.endsWith(".md"));
+
+        for (const file of files) {
+            const content = readFileContent(path.join(workflowsDir, file));
+            if (content) {
+                const frontmatter = extractFrontmatter(content);
+                workflows.push({
+                    command: `/${file.replace(".md", "")}`,
+                    description: frontmatter.description || "No description",
+                });
+            }
+        }
+
+        return {
+            content: [{
+                type: "text",
+                text: JSON.stringify({ workflows, count: workflows.length }, null, 2),
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: get_agent
+// ============================================================================
+
+server.tool(
+    "get_agent",
+    "Get the full content of a specific agent file",
+    {
+        name: z.string().describe("Agent name (e.g., 'orchestrator', 'frontend-specialist')"),
+    },
+    async ({ name }) => {
+        const agentPath = path.join(AGENT_DIR, "agents", `${name}.md`);
+
+        if (!fileExists(agentPath)) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: `Agent '${name}' not found` }),
+                }],
+            };
+        }
+
+        const content = readFileContent(agentPath);
+
+        return {
+            content: [{
+                type: "text",
+                text: content || "Failed to read agent file",
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: get_skill
+// ============================================================================
+
+server.tool(
+    "get_skill",
+    "Get the SKILL.md content for a specific skill",
+    {
+        name: z.string().describe("Skill name (e.g., 'react-patterns', 'clean-code')"),
+    },
+    async ({ name }) => {
+        const skillPath = path.join(AGENT_DIR, "skills", name, "SKILL.md");
+
+        if (!fileExists(skillPath)) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: `Skill '${name}' not found` }),
+                }],
+            };
+        }
+
+        const content = readFileContent(skillPath);
+
+        return {
+            content: [{
+                type: "text",
+                text: content || "Failed to read skill file",
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: get_workflow
+// ============================================================================
+
+server.tool(
+    "get_workflow",
+    "Get the content of a specific workflow file",
+    {
+        name: z.string().describe("Workflow name without slash (e.g., 'create', 'debug')"),
+    },
+    async ({ name }) => {
+        const workflowPath = path.join(AGENT_DIR, "workflows", `${name}.md`);
+
+        if (!fileExists(workflowPath)) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: `Workflow '${name}' not found` }),
+                }],
+            };
+        }
+
+        const content = readFileContent(workflowPath);
+
+        return {
+            content: [{
+                type: "text",
+                text: content || "Failed to read workflow file",
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Resource: Project Status
+// ============================================================================
+
+server.resource(
+    "agent-kit-status",
+    "status://agent-kit",
+    async (uri) => ({
+        contents: [{
+            uri: uri.href,
+            mimeType: "application/json",
+            text: JSON.stringify({
+                installed: fileExists(AGENT_DIR),
+                projectRoot: PROJECT_ROOT,
+                timestamp: new Date().toISOString(),
+            }),
+        }],
+    })
+);
+
+// ============================================================================
+// Start Server
+// ============================================================================
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Agent Kit Core 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-core/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-fs/package.json

@@ -0,0 +1,25 @@
+{
+    "name": "agent-kit-fs",
+    "version": "1.0.0",
+    "description": "MCP server for file system operations",
+    "type": "module",
+    "main": "dist/index.js",
+    "bin": {
+        "agent-kit-fs": "./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",
+        "glob": "^10.3.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.0.0",
+        "tsx": "^4.0.0",
+        "typescript": "^5.0.0"
+    }
+}