@musashishao/agent-kit 1.2.2

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

@@ -0,0 +1,283 @@
+#!/usr/bin/env node
+/**
+ * Agent Kit Git MCP Server
+ * 
+ * Provides Git operations tools for AI assistants.
+ * 
+ * Tools:
+ * - git_status: Get current git status
+ * - git_diff: Show changes
+ * - git_log: Show recent commits
+ * - git_branch: List branches
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { execSync } from "child_process";
+
+const PROJECT_ROOT = process.cwd();
+
+const server = new McpServer({
+    name: "agent-kit-git",
+    version: "1.0.0",
+});
+
+// ============================================================================
+// Helper Functions
+// ============================================================================
+
+function runGitCommand(command: string): { success: boolean; output: string; error?: string } {
+    try {
+        const output = execSync(command, {
+            cwd: PROJECT_ROOT,
+            encoding: "utf-8",
+            timeout: 30000,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        return { success: true, output: output.trim() };
+    } catch (error: unknown) {
+        const err = error as { stderr?: string; message?: string };
+        return {
+            success: false,
+            output: "",
+            error: err.stderr || err.message || "Git command failed",
+        };
+    }
+}
+
+function isGitRepo(): boolean {
+    const result = runGitCommand("git rev-parse --is-inside-work-tree");
+    return result.success && result.output === "true";
+}
+
+// ============================================================================
+// Tool: git_status
+// ============================================================================
+
+server.tool(
+    "git_status",
+    "Get the current git status including staged, modified, and untracked files",
+    {},
+    async () => {
+        if (!isGitRepo()) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Not a git repository" }),
+                }],
+            };
+        }
+
+        const status = runGitCommand("git status --porcelain");
+        const branch = runGitCommand("git branch --show-current");
+
+        const files = {
+            staged: [] as string[],
+            modified: [] as string[],
+            untracked: [] as string[],
+        };
+
+        if (status.success) {
+            const lines = status.output.split("\n").filter(Boolean);
+            for (const line of lines) {
+                const code = line.slice(0, 2);
+                const file = line.slice(3);
+
+                if (code.startsWith("A") || code.startsWith("M ") || code.startsWith("D ")) {
+                    files.staged.push(file);
+                } else if (code.includes("M") || code.includes("D")) {
+                    files.modified.push(file);
+                } else if (code === "??") {
+                    files.untracked.push(file);
+                }
+            }
+        }
+
+        return {
+            content: [{
+                type: "text",
+                text: JSON.stringify({
+                    branch: branch.output,
+                    files,
+                    totalChanges: files.staged.length + files.modified.length + files.untracked.length,
+                }, null, 2),
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: git_diff
+// ============================================================================
+
+server.tool(
+    "git_diff",
+    "Show git diff for specified files or all changes",
+    {
+        files: z.string().optional().describe("Specific file path, or omit for all changes"),
+        staged: z.boolean().optional().describe("Show staged changes (default: false)"),
+    },
+    async ({ files, staged }) => {
+        if (!isGitRepo()) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Not a git repository" }),
+                }],
+            };
+        }
+
+        let command = "git diff";
+        if (staged) command += " --staged";
+        if (files) command += ` -- "${files}"`;
+
+        // Limit output to prevent context overflow
+        command += " | head -500";
+
+        const result = runGitCommand(command);
+
+        return {
+            content: [{
+                type: "text",
+                text: result.success
+                    ? (result.output || "No changes")
+                    : JSON.stringify({ error: result.error }),
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: git_log
+// ============================================================================
+
+server.tool(
+    "git_log",
+    "Show recent git commits",
+    {
+        limit: z.number().optional().describe("Number of commits to show (default: 10, max: 50)"),
+        oneline: z.boolean().optional().describe("Show compact one-line format (default: true)"),
+    },
+    async ({ limit = 10, oneline = true }) => {
+        if (!isGitRepo()) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Not a git repository" }),
+                }],
+            };
+        }
+
+        const effectiveLimit = Math.min(limit, 50);
+        const format = oneline
+            ? "--oneline"
+            : "--format=%h %s (%an, %ar)";
+
+        const result = runGitCommand(`git log ${format} -n ${effectiveLimit}`);
+
+        return {
+            content: [{
+                type: "text",
+                text: result.success
+                    ? result.output
+                    : JSON.stringify({ error: result.error }),
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: git_branch
+// ============================================================================
+
+server.tool(
+    "git_branch",
+    "List git branches",
+    {
+        all: z.boolean().optional().describe("Include remote branches (default: false)"),
+    },
+    async ({ all = false }) => {
+        if (!isGitRepo()) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Not a git repository" }),
+                }],
+            };
+        }
+
+        const command = all ? "git branch -a" : "git branch";
+        const result = runGitCommand(command);
+
+        if (!result.success) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: result.error }),
+                }],
+            };
+        }
+
+        const branches = result.output.split("\n").map(b => ({
+            name: b.replace(/^\*?\s*/, "").trim(),
+            current: b.startsWith("*"),
+        })).filter(b => b.name);
+
+        return {
+            content: [{
+                type: "text",
+                text: JSON.stringify({ branches }, null, 2),
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Tool: git_show_file
+// ============================================================================
+
+server.tool(
+    "git_show_file",
+    "Show a file content from a specific commit",
+    {
+        file: z.string().describe("Path to the file"),
+        commit: z.string().optional().describe("Commit hash or ref (default: HEAD)"),
+    },
+    async ({ file, commit = "HEAD" }) => {
+        if (!isGitRepo()) {
+            return {
+                content: [{
+                    type: "text",
+                    text: JSON.stringify({ error: "Not a git repository" }),
+                }],
+            };
+        }
+
+        const result = runGitCommand(`git show ${commit}:"${file}" | head -200`);
+
+        return {
+            content: [{
+                type: "text",
+                text: result.success
+                    ? result.output
+                    : JSON.stringify({ error: result.error }),
+            }],
+        };
+    }
+);
+
+// ============================================================================
+// Start Server
+// ============================================================================
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Agent Kit Git 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-git/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/templates/README.md

@@ -0,0 +1,49 @@
+# MCP Server Templates
+
+> Pre-built templates for creating custom MCP servers.
+
+## Available Templates
+
+| Template | Description | Use Case |
+|----------|-------------|----------|
+| **api** | REST API integration | Connect to external APIs |
+| **database** | Database connector | Query PostgreSQL, SQLite, MongoDB |
+| **web-scraper** | Web scraping | Extract data from websites |
+| **custom** | Empty template | Build from scratch |
+
+## Usage
+
+```bash
+# Create a new MCP server from template
+npx @musashishao/agent-kit mcp create my-api-server --type api
+
+# List available templates
+npx @musashishao/agent-kit mcp templates
+```
+
+## Template Structure
+
+Each template contains:
+
+```
+template/
+├── package.json.template    # Package configuration
+├── tsconfig.json           # TypeScript config
+├── README.md.template      # Documentation
+└── src/
+    └── index.ts.template   # Main server file
+```
+
+## After Creating
+
+```bash
+cd .agent/mcp/servers/my-api-server
+npm install
+npm run build
+```
+
+Then configure your AI client:
+
+```bash
+npx @musashishao/agent-kit mcp setup --client claude
+```

package/.agent/mcp/templates/api/README.md.template

@@ -0,0 +1,45 @@
+# {{SERVER_NAME}}
+
+> MCP server for API integration
+
+## Setup
+
+1. Install dependencies:
+```bash
+npm install
+```
+
+2. Configure environment variables:
+```bash
+export API_BASE_URL="https://your-api.com"
+export API_KEY="your-api-key"
+```
+
+3. Build:
+```bash
+npm run build
+```
+
+4. Add to your AI client config.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `api_get` | Make GET request to API |
+| `api_post` | Make POST request to API |
+| `api_list_endpoints` | List available endpoints |
+
+## Customization
+
+Edit `src/index.ts` to:
+- Add more API endpoints
+- Customize authentication
+- Add validation logic
+
+## Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `API_BASE_URL` | Base URL of the API | Yes |
+| `API_KEY` | API authentication key | No |

package/.agent/mcp/templates/api/src/index.ts.template

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+/**
+ * {{SERVER_NAME}} - API Integration MCP Server
+ * 
+ * Connect your AI assistant to external APIs.
+ * 
+ * Generated by Agent Kit MCP Generator
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// Configuration - Update these values
+const API_BASE_URL = process.env.API_BASE_URL || "https://api.example.com";
+const API_KEY = process.env.API_KEY || "";
+
+const server = new McpServer({
+  name: "{{SERVER_NAME}}",
+  version: "1.0.0",
+});
+
+// ============================================================================
+// Helper Functions
+// ============================================================================
+
+async function apiRequest(
+  endpoint: string, 
+  method: "GET" | "POST" | "PUT" | "DELETE" = "GET",
+  body?: Record<string, unknown>
+): Promise<{ success: boolean; data?: unknown; error?: string }> {
+  try {
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+    };
+    
+    if (API_KEY) {
+      headers["Authorization"] = `Bearer ${API_KEY}`;
+    }
+    
+    const response = await fetch(`${API_BASE_URL}${endpoint}`, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined,
+    });
+    
+    if (!response.ok) {
+      return { 
+        success: false, 
+        error: `API error: ${response.status} ${response.statusText}` 
+      };
+    }
+    
+    const data = await response.json();
+    return { success: true, data };
+  } catch (error) {
+    return { 
+      success: false, 
+      error: `Request failed: ${error instanceof Error ? error.message : "Unknown error"}` 
+    };
+  }
+}
+
+// ============================================================================
+// Tool: api_get
+// ============================================================================
+
+server.tool(
+  "api_get",
+  "Make a GET request to the API",
+  {
+    endpoint: z.string().describe("API endpoint path (e.g., '/users', '/posts/1')"),
+  },
+  async ({ endpoint }) => {
+    const result = await apiRequest(endpoint, "GET");
+    
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(result, null, 2),
+      }],
+    };
+  }
+);
+
+// ============================================================================
+// Tool: api_post
+// ============================================================================
+
+server.tool(
+  "api_post",
+  "Make a POST request to the API",
+  {
+    endpoint: z.string().describe("API endpoint path"),
+    data: z.string().describe("JSON data to send"),
+  },
+  async ({ endpoint, data }) => {
+    let parsedData: Record<string, unknown>;
+    try {
+      parsedData = JSON.parse(data);
+    } catch {
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({ error: "Invalid JSON data" }),
+        }],
+      };
+    }
+    
+    const result = await apiRequest(endpoint, "POST", parsedData);
+    
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(result, null, 2),
+      }],
+    };
+  }
+);
+
+// ============================================================================
+// Tool: api_list_endpoints
+// ============================================================================
+
+server.tool(
+  "api_list_endpoints",
+  "List available API endpoints (customize this for your API)",
+  {},
+  async () => {
+    // TODO: Customize this list for your API
+    const endpoints = [
+      { method: "GET", path: "/users", description: "List all users" },
+      { method: "GET", path: "/users/:id", description: "Get user by ID" },
+      { method: "POST", path: "/users", description: "Create a new user" },
+      { method: "PUT", path: "/users/:id", description: "Update user" },
+      { method: "DELETE", path: "/users/:id", description: "Delete user" },
+    ];
+    
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({ 
+          baseUrl: API_BASE_URL,
+          endpoints,
+          note: "Customize this list in src/index.ts"
+        }, null, 2),
+      }],
+    };
+  }
+);
+
+// ============================================================================
+// Resource: API Status
+// ============================================================================
+
+server.resource(
+  "api-status",
+  "status://api",
+  async (uri) => ({
+    contents: [{
+      uri: uri.href,
+      mimeType: "application/json",
+      text: JSON.stringify({
+        connected: !!API_KEY,
+        baseUrl: API_BASE_URL,
+        timestamp: new Date().toISOString(),
+      }),
+    }],
+  })
+);
+
+// ============================================================================
+// Start Server
+// ============================================================================
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("{{SERVER_NAME}} MCP Server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Failed to start MCP server:", error);
+  process.exit(1);
+});

package/.agent/mcp/templates/base-package.json.template

@@ -0,0 +1,27 @@
+{
+  "name": "{{SERVER_NAME}}",
+  "version": "1.0.0",
+  "description": "MCP server for {{DESCRIPTION}}",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "{{SERVER_NAME}}": "./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"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/.agent/mcp/templates/base-tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "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"
+    ]
+}