Saltar a contenido

Referencia de Herramientas MCP de rai-workspace

El servidor MCP rai-workspace expone 23 herramientas en 7 dominios. Estas herramientas están disponibles para cualquier cliente compatible con MCP (Claude Code, Hermes Agent, etc.) cuando el servidor está en ejecución.

CLI vs MCP

No existe un CLI rai pipeline en RaiSE 3.0. Toda la orquestación de pipelines se ejecuta a través de estas herramientas MCP. Consulta Pipeline Quickstart para el flujo de trabajo recomendado.

Iniciar el servidor

El servidor se inicia automáticamente cuando Claude Code carga .claude/settings.json. Para iniciarlo manualmente:

python -m raise_cli.pipeline.mcp_server

Dominio Pipeline

Herramientas para orquestar el ciclo de vida de story/epic/bugfix.

pipeline_list

Lista los pipelines disponibles con sus fases.

pipeline_list() → str

Retorna una lista JSON de definiciones de pipeline encontradas en .raise/pipelines/. Úsalo para descubrir los nombres de pipeline disponibles antes de llamar a pipeline_start.

pipeline_start

Inicia una ejecución de pipeline. Retorna la primera fase a ejecutar.

pipeline_start(pipeline_name: str, issue_id: str) → str
Parámetro Descripción
pipeline_name Nombre del pipeline (p.ej., "story", "epic", "bugfix")
issue_id Clave de issue para trazabilidad (p.ej., "RAISE-1281")

Retorna un objeto JSON con run_id, current_phase, instruction y skill para la primera fase. Pasa run_id a las llamadas subsecuentes de pipeline_advance.

pipeline_advance

Marca la fase actual como completada y obtiene la siguiente.

pipeline_advance(run_id: str, approve: bool = False, cwd: str = "") → str
Parámetro Descripción
run_id ID de ejecución retornado por pipeline_start
approve Establece en True para aprobar un gate HITL en la fase actual
cwd Directorio de trabajo para resolución de artifacts. Requerido al llamar desde un git worktree (el CWD del servidor MCP difiere del CWD de la sesión). Por defecto usa el CWD del servidor.

Llámalo tras completar el skill de la fase actual. Si la fase tiene un gate HITL, la primera llamada retorna gate_pending — llama de nuevo con approve=True para pasarlo.

pipeline_pause

Pausa una ejecución de pipeline. La ejecución puede reanudarse llamando a pipeline_advance.

pipeline_pause(run_id: str) → str

pipeline_cancel

Cancela una ejecución de pipeline. Las ejecuciones canceladas no pueden reanudarse.

pipeline_cancel(run_id: str) → str

pipeline_restore

Restaura el estado completo del pipeline tras compactación o reinicio de sesión.

pipeline_restore(run_id: str) → str

Retorna el estado actual de ejecución y contexto para la fase actual. Úsalo al retomar trabajo tras una compactación de contexto o reinicio de Claude Code.

pipeline_status

Obtiene el estado actual de una ejecución de pipeline.

pipeline_status(run_id: str) → str

Retorna run_id, status, current_phase, total_phases e historial de fases.

pipeline_runs

Lista todas las ejecuciones de pipeline activas y recientes.

pipeline_runs() → str

Retorna las ejecuciones ordenadas por última actividad. Úsalo para encontrar un run_id al retomar después de una compactación.

Dominio Artifact

Herramientas para persistir y consultar artifacts estructurados de story (diseño, plan, retrospectiva).

raise_artifact_emit

Valida y persiste un artifact estructurado de story.

raise_artifact_emit(
    artifact_type: str,
    story_id: str,
    content: str,
    session_id: str = ""
) → str
Parámetro Descripción
artifact_type Uno de "design", "plan", "retrospective"
story_id Identificador de story (p.ej., "RAISE-1281")
content Cadena JSON con campos del artifact (ver docs del skill para el esquema por tipo)
session_id ID de sesión opcional para correlación

raise_artifact_query

Consulta artifacts por story y opcionalmente por tipo.

raise_artifact_query(story_id: str, artifact_type: str = "") → str
Parámetro Descripción
story_id Identificador de story
artifact_type Filtro opcional: "design", "plan", "retrospective"

Dominio Backlog

Herramientas para leer y actualizar ítems del backlog (Jira, adaptador de sistema de archivos).

raise_backlog_context

Obtiene detalles de un issue del backlog para contexto.

raise_backlog_context(issue_key: str, adapter: str = "jira") → str
Parámetro Descripción
issue_key Clave de issue (p.ej., "RAISE-1310")
adapter Nombre del adaptador: "jira" (por defecto) o "filesystem"

Retorna título, descripción, estado, etiquetas, padre y puntos de story.

raise_backlog_transition

Transiciona un issue del backlog a un nuevo estado.

raise_backlog_transition(
    issue_key: str,
    status: str,
    adapter: str = "jira"
) → str
Parámetro Descripción
issue_key Clave de issue (p.ej., "RAISE-1438")
status Slug del estado destino (p.ej., "implement", "done")
adapter Nombre del adaptador

raise_backlog_create

Crea un nuevo issue en el backlog.

raise_backlog_create(
    summary: str,
    project: str,
    issue_type: str = "Story",
    description: str = "",
    labels: str = "",
    parent: str = "",
    adapter: str = "jira"
) → str

Dominio Gate

raise_gate_check

Ejecuta verificaciones de quality gate.

raise_gate_check(gate_id: str | None = None) → str
Parámetro Descripción
gate_id Gate específico a verificar (p.ej., "gate-lint", "gate-tests"). Pasa None u omite para ejecutar todos los gates.

Retorna aprobado/fallido por gate con output. Los comandos se leen de .raise/manifest.yaml — las claves nulas se saltan automáticamente.

Dominio Graph

Herramientas para consultar el knowledge graph de RaiSE (símbolos, patrones, nodos de gobernanza).

raise_graph_query

Busca en el knowledge graph de RaiSE nodos relevantes.

raise_graph_query(query: str, limit: int = 5) → str
Parámetro Descripción
query Términos de búsqueda (p.ej., "pipeline session start", "storage SQLite")
limit Máximo de resultados a retornar (por defecto 5)

raise_graph_context

Obtiene contexto para un módulo específico del knowledge graph.

raise_graph_context(module_id: str) → str
Parámetro Descripción
module_id Identificador de módulo (p.ej., "mod-session", "mod-storage")

Dominio Pattern

Herramientas para consultar, agregar y reforzar patrones de comportamiento.

raise_pattern_query

Busca patrones de RaiSE por palabras clave.

raise_pattern_query(keywords: str, limit: int = 10) → str
Parámetro Descripción
keywords Términos de búsqueda contra el contenido del patrón y etiquetas de contexto
limit Máximo de resultados (por defecto 10)

raise_pattern_add

Agrega un nuevo patrón a la memoria.

raise_pattern_add(
    content: str,
    context: str,
    pattern_type: str = "process",
    from_story: str = ""
) → str
Parámetro Descripción
content Texto descriptivo del patrón
context Etiquetas de contexto separadas por coma (p.ej., "testing,mocks,integration")
pattern_type Uno de "process", "technical", "architecture", "codebase"
from_story Story que produjo este patrón (p.ej., "RAISE-1281")

raise_pattern_reinforce

Refuerza un patrón con una señal de voto.

raise_pattern_reinforce(
    pattern_id: str,
    vote: int,
    from_story: str = ""
) → str
Parámetro Descripción
pattern_id ID del patrón (p.ej., "PAT-E-1713")
vote 1 = seguido, 0 = no relevante, -1 = contradijo
from_story Contexto de story para el voto

Se llama en la revisión de story para registrar si un patrón fue aplicado. 0 no cuenta hacia las evaluaciones — úsalo para patrones que no fueron relevantes.

Dominio Session

Herramientas para emitir señales de ciclo de vida, cargar contexto y consultar el historial de sesiones.

raise_signal_emit

Emite una señal de ciclo de vida de trabajo para seguimiento.

raise_signal_emit(
    work_type: str,
    work_id: str,
    event: str,
    phase: str = "init",
    task: str = ""
) → str
Parámetro Descripción
work_type "epic" o "story"
work_id Identificador del trabajo (p.ej., "RAISE-1281", "E3978")
event "start", "complete" o "blocked"
phase Fase del flujo de trabajo: "init", "design", "plan", "implement", "review", "close"
task Identidad de tarea dentro de una fase (p.ej., "Tarea 1: agregar campos de esquema")

raise_session_context

Carga secciones de contexto de sesión de RaiSE para consumo por IA.

raise_session_context(sections: str = "progress,coaching") → str
Parámetro Descripción
sections Secciones separadas por coma: "progress", "coaching", "governance", "behavioral"

Retorna ~200 tokens de contexto de gobernanza para inyección en turnos de LLM.

raise_session_history

Consulta registros recientes de sesión con narrativas y resultados.

raise_session_history(
    limit: int = 10,
    epic: str = "",
    project_path: str = ""
) → str
Parámetro Descripción
limit Máximo de sesiones a retornar (por defecto 10)
epic Filtrar a sesiones de un epic específico (p.ej., "E2780"). Vacío = todos los epics.
project_path Ruta raíz del proyecto. Por defecto Path.cwd().

Retorna sesiones ordenadas por closed_at DESC con narrativa, next_session_prompt, resultados e IDs de patrones.

raise_session_topic

Emite un evento de tema de sesión para rastrear la fase y sub-paso actuales.

raise_session_topic(kind: str, topic: str) → str
Parámetro Descripción
kind Tipo de fase del skill (p.ej., "design", "implement", "close")
topic Sub-paso dentro de la fase (p.ej., "gemba", "examples", "merge")

Lo usan los skills como marcadores de token para mantener visible el foco de la sesión y alimentar el historial de sesiones.

Resumen de herramientas

Dominio Herramientas
Pipeline 8 (pipeline_list, pipeline_start, pipeline_advance, pipeline_pause, pipeline_cancel, pipeline_restore, pipeline_status, pipeline_runs)
Artifact 2 (raise_artifact_emit, raise_artifact_query)
Backlog 3 (raise_backlog_context, raise_backlog_transition, raise_backlog_create)
Gate 1 (raise_gate_check)
Graph 2 (raise_graph_query, raise_graph_context)
Pattern 3 (raise_pattern_query, raise_pattern_add, raise_pattern_reinforce)
Session 4 (raise_signal_emit, raise_session_context, raise_session_history, raise_session_topic)
Total 23

Ver también