Specifai

Integra y automatiza proyectos de Specifai con cualquier herramienta de IA compatible con MCP.

Documentación

Servidor MCP de Specifai

License: MIT npm version Install in VS Code (npx) Install in VS Code Insiders (npx) Install in Cursor (npx)

Hai Build Amazon Q VS Code Cursor Windsurf Zed

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración y automatización del proyecto Specifai con cualquier herramienta de IA compatible con MCP. Este servidor está diseñado para ser agnóstico respecto a la herramienta, lo que significa que puede usarse con cualquier herramienta que soporte el protocolo MCP. Actualmente, este servidor expone herramientas para leer todos los documentos generados por el proyecto Specifai.

[!ADVERTENCIA] Este servidor es actualmente experimental. La funcionalidad y las herramientas disponibles están sujetas a cambios y expansión a medida que continuamos desarrollando y mejorando el servidor.

Tabla de Contenidos

Requisitos

  • Node.js >= 16.0.0
  • Bun >= 1.0.0 (si se usa el runtime de Bun)
  • Hai Build, Cursor, Windsurf, Claude Desktop o cualquier Cliente MCP

Instalación

# Latest version
npx --yes @presidio-dev/specifai-mcp-server@latest

# Specific version
npx --yes @presidio-dev/specifai-mcp-server@1.2.3

Recomendamos npx para instalar el servidor, pero puedes usar cualquier gestor de paquetes de Node de tu preferencia, como yarn, pnpm, bun, etc.

Configuración

con npx con la última versión:

{
  "specifai": {
    "command": "npx",
    "args": ["--yes", "@presidio-dev/specifai-mcp-server@latest"],
    "disabled": false,
    "autoApprove": []
  }
}

con npx con una versión específica:

{
  "specifai": {
    "command": "npx",
    "args": ["--yes", "@presidio-dev/specifai-mcp-server@1.2.3"],
    "disabled": false,
    "autoApprove": []
  }
}

Preparando tu proyecto

Esto es completamente opcional, pero se recomienda usarlo para evitar tener que especificar la ruta del directorio del proyecto cada vez que accedas al servidor. Para IDE/Extensión de IA (Hai Build), se recomienda usar un archivo .specifai-path para especificar la ruta del directorio del proyecto.

Asegúrate de que el directorio raíz de tu proyecto contenga un archivo .specifai-path. Así es como el servidor MCP de Specifai sabe dónde encontrar los documentos de especificación generados por Specifai.

El archivo es un archivo de texto plano que contiene la ruta absoluta al directorio del proyecto donde se almacenan los documentos de especificación de un proyecto.

Por ejemplo, si tu directorio de proyecto está ubicado en /path/to/project, el archivo .specifai-path debe contener la siguiente línea:

/path/to/project

Integración de Specifai MCP con IDE y extensiones populares

Consulta las instrucciones de configuración para cada uno

Instalar en Hai Build

Agrega lo siguiente a tu archivo hai_mcp_settings.json. Para abrir este archivo desde Hai Build, haz clic en el ícono "MCP Servers", selecciona la pestaña "Installed" y luego haz clic en "Configure MCP Servers".

Consulta la documentación de MCP de Hai Build para más información.

{
  "mcpServers": {
    "specifai": {
      "command": "npx",
      "args": ["-y", "@presidio-dev/specifai-mcp-server@latest"]
    }
  }
}
Instalar en Amazon Q Developer

Agrega lo siguiente a tu archivo de configuración de Amazon Q Developer. Consulta Configuración de MCP para Q Developer en el IDE para más detalles.

El archivo de configuración puede almacenarse globalmente en ~/.aws/amazonq/mcp.json para estar disponible en todos tus proyectos, o localmente dentro de tu proyecto en .amazonq/mcp.json.

{
  "mcpServers": {
    "specifai": {
      "command": "npx",
      "args": ["-y", "@presidio-dev/specifai-mcp-server@latest"]
    }
  }
}
Instalar en VS Code (Copilot)

Install in VS Code (npx) Install in VS Code Insiders (npx)

Primero, habilita el soporte de MCP en VS Code abriendo Configuración (Ctrl+,), buscando mcp.enabled y marcando la casilla.

Luego, agrega la siguiente configuración a tu archivo settings.json de usuario o espacio de trabajo. Consulta la documentación de MCP de VS Code para más información.

"mcp": {
  "servers": {
    "specifai": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@presidio-dev/specifai-mcp-server@latest"]
    }
  }
}
Instalar en Cursor

La forma más fácil de instalar es con el botón de instalación con un clic a continuación.

Install in Cursor (npx)

Alternativamente, puedes configurar manualmente el servidor agregando lo siguiente a tu archivo mcp.json. Este archivo puede ubicarse globalmente en ~/.cursor/mcp.json o dentro de un proyecto específico en .cursor/mcp.json. Consulta la documentación de MCP de Cursor para más información.

{
  "mcpServers": {
    "specifai": {
      "command": "npx",
      "args": ["--yes", "@presidio-dev/specifai-mcp-server@latest"]
    }
  }
}
Instalar en Windsurf

Agrega lo siguiente a tu archivo ~/.codeium/windsurf/mcp_config.json. Consulta la documentación de MCP de Windsurf para más información.

{
  "mcpServers": {
    "specifai": {
      "command": "npx",
      "args": ["-y", "@presidio-dev/specifai-mcp-server@latest"]
    }
  }
}
Instalar en Zed

Puedes agregar el servidor MCP de Specifai en Zed editando tu archivo settings.json (accesible mediante la acción zed: settings) o usando la interfaz de configuración del Panel de Agente (agent: open configuration). Consulta la documentación de MCP de Zed para más información.

Agrega lo siguiente a tu settings.json:

{
  "context_servers": {
    "specifai": {
      "command": {
        "path": "npx",
        "args": ["-y", "@presidio-dev/specifai-mcp-server@latest"]
      }
    }
  }
}

Herramientas Disponibles

El servidor proporciona varias herramientas para interactuar con tus documentos de especificación:

Nombre de la HerramientaDescripción
get-brdsObtener Documentos de Requisitos de Negocio
get-prdsObtener Documentos de Requisitos de Producto
get-nfrsObtener Requisitos No Funcionales
get-uirsObtener Requisitos de Interfaz de Usuario
get-bpdsObtener Documentos de Procesos de Negocio
get-tcsObtener Documentos de Casos de Prueba
get-user-storiesObtener Historias de Usuario para un PRD específico
get-tasksObtener Tareas para una Historia de Usuario específica
get-taskObtener detalles de una Tarea específica
set-project-pathEstablecer o cambiar la ruta del directorio del proyecto
get-task-by-idObtener detalles de una Tarea específica por ID
list-all-tasksListar todas las tareas disponibles
searchBúsqueda de texto completo en todos los documentos

Contribuciones

¡Damos la bienvenida a contribuciones al Servidor MCP de Specifai! Consulta nuestra Guía de Contribuciones para más información sobre cómo comenzar.

Configuración de Desarrollo

Para instrucciones detalladas sobre cómo configurar tu entorno de desarrollo, consulta nuestra Guía de Configuración de Desarrollo.

Arquitectura

Para entender la arquitectura del proyecto, consulta nuestra Guía de Arquitectura.

Seguridad

Para información sobre nuestra política de seguridad y cómo reportar vulnerabilidades de seguridad, consulta nuestra Política de Seguridad.

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENCIA para más detalles.

Agradecimientos