Code-MCP

import { z } from "zod"; /** * Communication Tools - Automate documentation and git messaging */ // ============================================ // Generate Commit Message // ============================================ export const generateCommitMessageSchema = { name: "generate_commit_message", description: "Generates a semantic commit message based on changes", inputSchema: z.object({ type: z .enum([ "feat", "fix", "docs", "style", "refactor", "test", "chore", "perf", "ci", "build", "revert", ]) .describe("Commit type"), scope: z .string() .optional() .describe("Scope of the change (e.g. 'auth', 'api')"), description: z.string().describe("Short description of what changed"), breaking: z.boolean().optional().describe("Is this a breaking change?"), details: z.string().optional().describe("Detailed explanation (body)"), }), }; export function generateCommitMessageHandler(args: { type: string; scope?: string; description: string; breaking?: boolean; details?: string; }) { const { type, scope, description, breaking, details } = args; const scopeStr = scope ? `(${scope})` : ""; const breakingMark = breaking ? "!" : ""; let message = `${type}${scopeStr}${breakingMark}: ${description}`; if (details || breaking) { message += "\n\n"; if (breaking) { message += "BREAKING CHANGE: " + (details || description) + "\n"; } if (details) { message += details; } } return { content: [ { type: "text", text: `# Generated Commit Message\n\n\`\`\`text\n${message}\n\`\`\`\n\n**To verify:**\n1. Check if type '${type}' is correct.\n2. Ensure description is imperative ("add" not "added").`, }, ], }; } // ============================================ // Generate PR Description // ============================================ export const generatePRDescriptionSchema = { name: "generate_pr_description", description: "Generates a comprehensive Pull Request description", inputSchema: z.object({ title: z.string().describe("PR Title"), type: z .enum(["feature", "bugfix", "refactor", "docs", "maintenance"]) .describe("Type of PR"), summary: z.string().describe("High-level summary of changes"), changes: z.array(z.string()).describe("List of specific changes"), testing: z.string().optional().describe("How to test these changes"), relatedIssues: z .array(z.string()) .optional() .describe("Linked issue numbers"), }), }; export function generatePRDescriptionHandler(args: { title: string; type: string; summary: string; changes: string[]; testing?: string; relatedIssues?: string[]; }) { const { title, type, summary, changes, testing, relatedIssues = [] } = args; const labels: Record<string, string> = { feature: "✨ Feature", bugfix: "🐛 Bug Fix", refactor: "♻️ Refactor", docs: "📚 Documentation", maintenance: "🔧 Maintenance", }; const md = `# ${title} ## Type of Change - [${type === "feature" ? "x" : " "}] ✨ New feature - [${type === "bugfix" ? "x" : " "}] 🐛 Bug fix - [${type === "refactor" ? "x" : " "}] ♻️ Refactoring - [${type === "docs" ? "x" : " "}] 📚 Documentation - [${type === "maintenance" ? "x" : " "}] 🔧 Maintenance ## Summary ${summary} ## 🔍 Key Changes ${changes.map((c) => `- ${c}`).join("\n")} ## 🧪 Testing Plan ${testing || "N/A"} ## 🔗 Related Issues ${relatedIssues.length ? relatedIssues.map((i) => `- Closes #${i}`).join("\n") : "None"} ## ✅ Checklist - [ ] Code follows project style guidelines - [ ] Tests passed locally - [ ] Documentation updated `; return { content: [ { type: "text", text: `# PR Description\n\n\`\`\`markdown\n${md}\n\`\`\``, }, ], }; } // ============================================ // Update Changelog // ============================================ export const updateChangelogSchema = { name: "update_changelog", description: "Generates a changelog entry following 'Keep a Changelog' format", inputSchema: z.object({ version: z.string().describe("New version number (e.g. 1.2.0)"), date: z.string().optional().default(new Date().toISOString().split("T")[0]), added: z.array(z.string()).optional(), changed: z.array(z.string()).optional(), deprecated: z.array(z.string()).optional(), removed: z.array(z.string()).optional(), fixed: z.array(z.string()).optional(), security: z.array(z.string()).optional(), }), }; export function updateChangelogHandler(args: { version: string; date?: string; added?: string[]; changed?: string[]; deprecated?: string[]; removed?: string[]; fixed?: string[]; security?: string[]; }) { const { version, date, added, changed, deprecated, removed, fixed, security, } = args; let content = `## [${version}] - ${date}\n`; const sections = [ { title: "Added", items: added }, { title: "Changed", items: changed }, { title: "Deprecated", items: deprecated }, { title: "Removed", items: removed }, { title: "Fixed", items: fixed }, { title: "Security", items: security }, ]; sections.forEach((sec) => { if (sec.items && sec.items.length > 0) { content += `\n### ${sec.title}\n${sec.items.map((i) => `- ${i}`).join("\n")}`; } }); return { content: [ { type: "text", text: `# Changelog Entry\n\n\`\`\`markdown\n${content}\n\`\`\`\n\n📋 **Action**: Prepend this to your \`CHANGELOG.md\`.`, }, ], }; } // Export all export const communicationTools = { generateCommitMessageSchema, generateCommitMessageHandler, generatePRDescriptionSchema, generatePRDescriptionHandler, updateChangelogSchema, updateChangelogHandler, };