@dami_deleon/rikudo 1.0.1-alpha.3 → 2.0.0

package/README.md

@@ -14,6 +14,7 @@ Inspirado en el Sabio de los Seis Caminos, Rikudo utiliza seis módulos especial
 4.  **Camino Preta (Summarizer):** Absorción y síntesis de archivos de gran tamaño.
 5.  **Camino Naraka (Cache):** Memoria persistente basada en hashes de Git para optimizar tokens.
 6.  **Camino Asura (Rate Limiter):** Gestión de poder para respetar los límites de las APIs.
+7.  **Camino MCP (Model Context Protocol):** Servidor MCP para integrar Rikudo con agentes de IA externos.
 
 
 ## ✨ Características Principales
@@ -29,6 +30,7 @@ Inspirado en el Sabio de los Seis Caminos, Rikudo utiliza seis módulos especial
 * **🚀 PR Generator:** Selecciona múltiples commits y genera una descripción de Pull Request completa siguiendo tu plantilla.
 * **⚙️ Configuración Flexible:** Define tus preferencias globales o por proyecto.
 * **🔍 Diagnóstico Integrado:** Herramienta `test` para verificar tus API Keys y conexión con servicios externos (Redmine, IA, etc.).
+* **🔌 Servidor MCP:** Actúa como skill library para agentes de IA externos mediante el protocolo MCP (Model Context Protocol).
 
 ## 📦 Instalación
 
@@ -95,6 +97,87 @@ rikudo config
 ```
 
 
+## 🔌 Servidor MCP (Model Context Protocol)
+
+Rikudo funciona como un servidor MCP, exponiendo herramientas y prompts para que cualquier agente de IA externo compatible con MCP pueda interactuar con tu flujo de trabajo de desarrollo.
+
+### Iniciar el Servidor
+
+```bash
+rikudo mcp
+```
+
+El servidor se comunica mediante **stdio** (entrada/salida estándar), lo que permite integrarlo con cualquier cliente MCP.
+
+### Herramientas Disponibles
+
+| Herramienta | Descripción |
+|------------|-------------|
+| `validate_configuration` | Verifica que las variables de entorno necesarias (Redmine, Gitea) estén configuradas correctamente. |
+| `get_ticket_context` | Obtiene el contexto completo de un ticket de Redmine (título, descripción, estado, prioridad). |
+| `get_git_diff` | Retorna el diff de los archivos que están en staging (`git add`). |
+| `shift_left_start` | Flujo shift-left completo: checkout a rama objetivo, crea nueva rama, commit vacío y abre Draft PR en Gitea. Soporta parámetro `isWip` para usar prefijo "WIP:" en el título. |
+| `update_pm_redmine` | Agrega un comentario a un ticket de Redmine para notificar al Project Manager. |
+
+### Prompts Disponibles
+
+| Prompt | Descripción |
+|--------|-------------|
+| `start_feature` | Inicia el flujo de trabajo para una nueva feature. Obtiene contexto del ticket, genera nombre de rama y prepara el entorno en Gitea con PR en modo WIP. |
+| `review_and_comment` | Analiza los cambios staged, genera un comentario técnico y lo publica en Redmine. |
+
+### Integración con Agentes IA
+
+Rikudo es compatible con cualquier herramienta de IA que soporte el protocolo MCP, como:
+- **Claude Code / Claude Desktop**
+- **Gemini CLI**
+- **Cursor**
+- **Windsurf**
+- **Continue**
+- Y cualquier otro cliente MCP
+
+#### Configuración Genérica
+
+Agrega esto en la configuración de tu cliente MCP:
+
+```json
+{
+  "mcpServers": {
+    "rikudo": {
+      "command": "rikudo",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+### Variables de Entorno para MCP
+
+El servidor MCP requiere las siguientes variables de entorno:
+
+```env
+# Redmine
+RIKUDO_REDMINE_URL=https://redmine.tuempresa.com
+RIKUDO_REDMINE_API_KEY=tu_redmine_key
+
+# Gitea
+RIKUDO_GITEA_URL=https://gitea.tuempresa.com
+RIKUDO_GITEA_TOKEN=tu_gitea_token
+RIKUDO_GITEA_OWNER=tu_usuario_o_organizacion
+RIKUDO_GITEA_REPO=nombre_del_repositorio
+```
+
+### Formato de Ramas
+
+Al usar `start_feature` o `shift_left_start`, el nombre de rama sigue el formato:
+
+```
+[numero-tarea]-[titulo-tarea-ingles-corto]
+```
+
+Ejemplo: `1234-add-user-authentication`
+
+
 
 ## ⚙️ Configuración
 
@@ -119,6 +202,12 @@ RIKUDO_OLLAMA_MODEL=llama3
 RIKUDO_REDMINE_URL=https://redmine.tuempresa.com
 RIKUDO_REDMINE_API_KEY=tu_redmine_key
 
+# --- Gitea (para servidor MCP) ---
+RIKUDO_GITEA_URL=https://gitea.tuempresa.com
+RIKUDO_GITEA_TOKEN=tu_gitea_token
+RIKUDO_GITEA_OWNER=tu_usuario_o_organizacion
+RIKUDO_GITEA_REPO=nombre_del_repositorio
+
 ```
 
 ### Plantillas Personalizadas (Templates)

package/dist/ai/prompts.js

@@ -36,7 +36,6 @@ Registro del Último Commit (Log Técnico): ${commitMessage}
 
 SALIDA:
 Solo devuelve el comentario, sin títulos o subtítulos o lineas de saludos.
-
 `;
 }
 export function generatePullRequestMessagePrompt(commits, ticketInfo, template) {
@@ -65,6 +64,6 @@ INSTRUCCIONES:
 
 SALIDA:
 Solo el contenido de la plantilla rellena.
-  `;
+`;
     return prompt;
 }

package/dist/index.js

@@ -16,6 +16,7 @@ import { generateCommitMessagePrompt, generateProjectManagerCommentPrompt, gener
 import { getConventions, getPRTemplate } from "./utils/config.js";
 import { showIssueMenu } from "./menus/issueMenu.js";
 import { runDiagnostics } from "./test/connection.js";
+import { runMCPServer } from "./mcp/server.js";
 import { COMMIT_CONVENTIONS_PATH, ENV_PATH, PULL_REQUEST_TEMPLATE_PATH } from "./const/paths.js";
 // --- Setup ---
 const __filename = fileURLToPath(import.meta.url);
@@ -62,6 +63,14 @@ program
     .command("config")
     .description("Abrir menú de configuración")
     .action(() => showConfigMenu());
+// MCP Server
+program
+    .command("mcp")
+    .description("Iniciar servidor MCP (Model Context Protocol) para agentes de IA")
+    .action(async (options) => {
+    loadEnv(options.env);
+    await runMCPServer();
+});
 // --- Modo Interactivo (Default) ---
 program
     .description("Modo interactivo del Sabio Rikudo")

package/dist/mcp/server.js

@@ -0,0 +1,226 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { simpleGit } from "simple-git";
+import { getIssueDetails, updateIssueComment } from "../services/redmine.js";
+import { getStagedDiff } from "../services/git.js";
+import { createPullRequest } from "../services/gitea.js";
+import { loadEnv } from "../utils/env.js";
+import { getConfig } from "../utils/config.js";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packagePath = path.resolve(__dirname, "../../package.json");
+const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
+const git = simpleGit();
+const server = new McpServer({
+    name: "rikudo-mcp-server",
+    version: packageJson.version || "1.0.0",
+});
+server.registerTool("get_ticket_context", {
+    title: "Get Ticket Context",
+    description: "Obtiene el contexto completo de un ticket de Redmine (título, descripción, estado, prioridad).",
+    inputSchema: z.object({
+        ticketId: z.string().describe("ID del ticket de Redmine (ej: '1234')"),
+    }),
+}, async ({ ticketId }) => {
+    try {
+        const ticket = await getIssueDetails(ticketId);
+        if (!ticket) {
+            return {
+                content: [{ type: "text", text: `No se pudo obtener el ticket #${ticketId}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: ticket.id,
+                        subject: ticket.subject,
+                        description: ticket.description,
+                        status: ticket.status,
+                        priority: ticket.priority,
+                        author: ticket.author,
+                        url: ticket.url,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Error desconocido";
+        return { content: [{ type: "text", text: `Error: ${errorMessage}` }], isError: true };
+    }
+});
+server.registerTool("get_git_diff", {
+    title: "Get Git Diff",
+    description: "Obtiene el diff de los cambios que están en staging (git add). Retorna el diff crudo.",
+    inputSchema: z.object({}),
+}, async () => {
+    try {
+        const diff = await getStagedDiff();
+        if (!diff) {
+            return {
+                content: [{ type: "text", text: "No hay cambios en staging. Ejecuta 'git add' primero." }],
+                isError: true,
+            };
+        }
+        return { content: [{ type: "text", text: diff }] };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Error desconocido";
+        return { content: [{ type: "text", text: `Error: ${errorMessage}` }], isError: true };
+    }
+});
+server.registerTool("validate_configuration", {
+    title: "Validate Configuration",
+    description: "Verifica si todas las variables de entorno necesarias para Rikudo (Redmine, Gitea y Proveedor de IA) están configuradas correctamente en el sistema del usuario. Llama a esta herramienta antes de intentar interactuar con tickets o repositorios.",
+    inputSchema: z.object({}),
+}, async () => {
+    const config = getConfig();
+    const missingVars = [];
+    if (!config.REDMINE_URL)
+        missingVars.push("RIKUDO_REDMINE_URL");
+    if (!config.REDMINE_API_KEY)
+        missingVars.push("RIKUDO_REDMINE_API_KEY");
+    if (!config.GITEA_URL)
+        missingVars.push("RIKUDO_GITEA_URL");
+    if (!config.GITEA_TOKEN)
+        missingVars.push("RIKUDO_GITEA_TOKEN");
+    if (missingVars.length === 0) {
+        return {
+            content: [{ type: "text", text: "✅ Configuración de entorno válida. Todos los sistemas listos." }],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `❌ Faltan las siguientes variables de entorno: ${missingVars.join(", ")}. Por favor, pide al usuario que las configure en su archivo .env antes de continuar.`,
+            },
+        ],
+        isError: true,
+    };
+});
+server.registerTool("shift_left_start", {
+    title: "Shift Left Start",
+    description: "Inicia un flujo shift-left: hace checkout a la rama objetivo, crea una nueva rama, hace commit vacío y abre un Draft PR en Gitea.",
+    inputSchema: z.object({
+        ticketId: z.string().describe("ID del ticket de Redmine (ej: '1234')"),
+        branchName: z.string().describe("Nombre de la nueva rama a crear (ej: '1234-add-user-auth')"),
+        targetBranch: z.string().default("alpha").describe("Rama base para hacer checkout (default: 'alpha')"),
+        isWip: z.boolean().default(false).describe("Si es true, el PR título lleva prefijo 'WIP:' (Work In Progress)"),
+    }),
+}, async ({ ticketId, branchName, targetBranch, isWip }) => {
+    try {
+        await git.checkout(targetBranch);
+        await git.pull("origin", targetBranch);
+        await git.checkoutLocalBranch(branchName);
+        await git.commit("chore: init #" + ticketId, ["--allow-empty"]);
+        await git.push(["-u", "origin", branchName]);
+        const ticket = await getIssueDetails(ticketId);
+        const prTitle = isWip
+            ? `WIP: ${ticket?.subject || `Ticket #${ticketId}`}`
+            : `Draft: ${ticket?.subject || `Ticket #${ticketId}`}`;
+        const prBody = `## Descripción\n\nTrabajo iniciado para el ticket #${ticketId}${ticket ? `\n\n**${ticket.subject}**` : ""}`;
+        const prResult = await createPullRequest({
+            title: prTitle,
+            head: branchName,
+            base: targetBranch,
+            body: prBody,
+            draft: true,
+        });
+        if (!prResult.success) {
+            return {
+                content: [{ type: "text", text: `Rama '${branchName}' creada y empujada a origin. Error al crear PR: ${prResult.error}` }],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        branch: branchName,
+                        targetBranch,
+                        prUrl: prResult.url,
+                        prNumber: prResult.number,
+                        message: `Entorno preparado en rama '${branchName}'. Draft PR creado: ${prResult.url}`,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Error desconocido";
+        return { content: [{ type: "text", text: `Error en shift_left_start: ${errorMessage}` }], isError: true };
+    }
+});
+server.registerTool("update_pm_redmine", {
+    title: "Update PM Redmine",
+    description: "Agrega un comentario a un ticket de Redmine. Ideal para notificar al Project Manager.",
+    inputSchema: z.object({
+        ticketId: z.string().describe("ID del ticket de Redmine (ej: '1234')"),
+        commentMarkdown: z.string().describe("Comentario en formato Markdown/Textile para Redmine"),
+    }),
+}, async ({ ticketId, commentMarkdown }) => {
+    try {
+        await updateIssueComment(ticketId, commentMarkdown);
+        return {
+            content: [{ type: "text", text: `Comentario agregado exitosamente al ticket #${ticketId}` }],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Error desconocido";
+        return { content: [{ type: "text", text: `Error actualizando Redmine: ${errorMessage}` }], isError: true };
+    }
+});
+server.registerPrompt("start_feature", {
+    title: "Start Feature",
+    description: "Inicia el flujo de trabajo para una nueva feature. Obtiene contexto del ticket y prepara el entorno en Gitea.",
+    argsSchema: {
+        ticket_id: z.string().describe("ID del ticket de Redmine"),
+    },
+}, async ({ ticket_id }) => {
+    return {
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Eres un asistente de desarrollo. Llama a la herramienta 'get_ticket_context' para el ticket ${ticket_id}. Lee su título y descripción. Genera un nombre de rama en inglés, cortas y en minúsculas, con el formato '[numero-tarea]-[titulo-tarea-ingles-corto]' (ej: '1234-add-user-authentication'). Luego, llama obligatoriamente a la herramienta 'shift_left_start' con esos datos para preparar mi entorno de trabajo en Gitea.`,
+                },
+            },
+        ],
+    };
+});
+server.registerPrompt("review_and_comment", {
+    title: "Review and Comment",
+    description: "Analiza los cambios staged, genera un comentario técnico para el Project Manager y lo publica en Redmine.",
+    argsSchema: {
+        ticket_id: z.string().describe("ID del ticket de Redmine"),
+    },
+}, async ({ ticket_id }) => {
+    return {
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Llama a la herramienta 'get_git_diff'. Analiza profundamente los cambios de código. Redacta un comentario técnico formal para el Project Manager explicando qué se hizo. Finalmente, llama a la herramienta 'update_pm_redmine' con el ${ticket_id} y el comentario generado para notificar al equipo.`,
+                },
+            },
+        ],
+    };
+});
+export async function runMCPServer() {
+    loadEnv();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Rikudo MCP Server started");
+}

package/dist/services/gitea.js

@@ -0,0 +1,59 @@
+import axios, { AxiosError } from "axios";
+const getGiteaConfig = () => {
+    return {
+        url: process.env.RIKUDO_GITEA_URL || "",
+        token: process.env.RIKUDO_GITEA_TOKEN || "",
+        owner: process.env.RIKUDO_GITEA_OWNER || "",
+        repo: process.env.RIKUDO_GITEA_REPO || "",
+    };
+};
+const getGiteaClient = () => {
+    const config = getGiteaConfig();
+    return axios.create({
+        baseURL: config.url,
+        headers: {
+            Authorization: `token ${config.token}`,
+            "Content-Type": "application/json",
+        },
+    });
+};
+export const createPullRequest = async (payload) => {
+    const config = getGiteaConfig();
+    if (!config.url || !config.token || !config.owner || !config.repo) {
+        return {
+            success: false,
+            error: "Faltan variables de entorno de Gitea (RIKUDO_GITEA_URL, RIKUDO_GITEA_TOKEN, RIKUDO_GITEA_OWNER, RIKUDO_GITEA_REPO)",
+        };
+    }
+    try {
+        const client = getGiteaClient();
+        const endpoint = `/api/v1/repos/${config.owner}/${config.repo}/pulls`;
+        const response = await client.post(endpoint, {
+            title: payload.title,
+            head: payload.head,
+            base: payload.base,
+            body: payload.body,
+            draft: payload.draft ?? false,
+        });
+        return {
+            success: true,
+            url: response.data.html_url,
+            number: response.data.number,
+        };
+    }
+    catch (error) {
+        if (error instanceof AxiosError) {
+            return {
+                success: false,
+                error: `Error de Gitea: ${error.message} - ${error.response?.data?.message || ""}`,
+            };
+        }
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : "Error desconocido al crear PR",
+        };
+    }
+};
+export const Gitea = {
+    createPullRequest,
+};

package/dist/utils/config.js

@@ -17,6 +17,10 @@ export function getConfig() {
         REDMINE_URL: process.env.RIKUDO_REDMINE_URL || "",
         REDMINE_API_KEY: process.env.RIKUDO_REDMINE_API_KEY || "",
         PROJECT_ID: process.env.RIKUDO_REDMINE_PROJECT_ID || "",
+        GITEA_URL: process.env.RIKUDO_GITEA_URL || "",
+        GITEA_TOKEN: process.env.RIKUDO_GITEA_TOKEN || "",
+        GITEA_OWNER: process.env.RIKUDO_GITEA_OWNER || "",
+        GITEA_REPO: process.env.RIKUDO_GITEA_REPO || "",
     };
 }
 export function getLimits() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dami_deleon/rikudo",
-  "version": "1.0.1-alpha.3",
+  "version": "2.0.0",
   "description": "El Sabio de los Commits: AI Assistant con integración a Redmine",
   "main": "dist/index.js",
   "type": "module",
@@ -35,6 +35,7 @@
     "@anthropic-ai/sdk": "0.74.0",
     "@google/generative-ai": "0.24.1",
     "@inquirer/prompts": "8.2.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "@types/figlet": "1.7.0",
     "axios": "1.13.2",
     "chalk": "5.6.2",