Specifai
Integra y automatiza proyectos de Specifai con cualquier herramienta de IA compatible con MCP.
Documentación
Servidor MCP de Specifai
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
- Instalación
- Configuración
- Preparando tu Proyecto
- Integración con IDE
- Herramientas Disponibles
- Contribuciones
- Seguridad
- Licencia
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-pathpara 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)
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.
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 Herramienta | Descripción |
|---|---|
get-brds | Obtener Documentos de Requisitos de Negocio |
get-prds | Obtener Documentos de Requisitos de Producto |
get-nfrs | Obtener Requisitos No Funcionales |
get-uirs | Obtener Requisitos de Interfaz de Usuario |
get-bpds | Obtener Documentos de Procesos de Negocio |
get-tcs | Obtener Documentos de Casos de Prueba |
get-user-stories | Obtener Historias de Usuario para un PRD específico |
get-tasks | Obtener Tareas para una Historia de Usuario específica |
get-task | Obtener detalles de una Tarea específica |
set-project-path | Establecer o cambiar la ruta del directorio del proyecto |
get-task-by-id | Obtener detalles de una Tarea específica por ID |
list-all-tasks | Listar todas las tareas disponibles |
search | Bú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
- Protocolo de Contexto de Modelo - La especificación del protocolo que implementa este servidor
- Specifai - El proyecto con el que se integra este servidor