Specifai

Integre e automatize projetos do Specifai com qualquer ferramenta de IA compatível com MCP.

Documentação

Servidor MCP Specifai

Hai Build Amazon Q VS Code Cursor Windsurf Zed

Um servidor Model Context Protocol (MCP) para integração e automação do projeto Specifai com qualquer ferramenta de IA compatível com MCP. Este servidor foi projetado para ser agnóstico em relação à ferramenta, ou seja, pode ser usado com qualquer ferramenta que suporte o protocolo MCP. Atualmente, este servidor expõe ferramentas para ler todos os documentos gerados pelo projeto Specifai.

[!WARNING] Este servidor está atualmente em fase experimental. A funcionalidade e as ferramentas disponíveis estão sujeitas a alterações e expansões à medida que continuamos a desenvolver e melhorar o servidor.

Requisitos

Node.js >= 16.0.0
Bun >= 1.0.0 (se estiver usando o runtime Bun)
Hai Build, Cursor, Windsurf, Claude Desktop ou qualquer Cliente MCP

Instalação

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

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

Recomendamos o uso do npx para instalar o servidor, mas você pode usar qualquer gerenciador de pacotes Node de sua preferência, como yarn, pnpm, bun, etc.

Configuração

com npx com a versão mais recente:

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

com npx com uma versão específica:

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

Preparando seu projeto

Isso é completamente opcional, mas é recomendado para evitar ter que especificar o caminho do diretório do projeto toda vez que você acessar o servidor. Para IDE de IA / Extensão (Hai Build), é recomendado usar um arquivo .specifai-path para especificar o caminho do diretório do projeto.

Certifique-se de que o diretório raiz do seu projeto contenha um arquivo .specifai-path. É assim que o servidor MCP Specifai sabe onde encontrar os documentos de especificação gerados pelo Specifai.

O arquivo é um arquivo de texto simples contendo o caminho absoluto para o diretório do projeto onde os documentos de especificação de um projeto estão armazenados.

Por exemplo, se o diretório do seu projeto estiver localizado em /path/to/project, o arquivo .specifai-path deve conter a seguinte linha:

/path/to/project

Integração do MCP Specifai com IDE e extensões populares

Consulte as instruções de configuração para cada um

Instalar no Hai Build

Adicione o seguinte ao seu arquivo hai_mcp_settings.json. Para abrir este arquivo no Hai Build, clique no ícone "MCP Servers", selecione a aba "Instalado" e depois clique em "Configurar Servidores MCP".

Consulte a documentação MCP do Hai Build para mais informações.

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

Instalar no Amazon Q Developer

Adicione o seguinte ao arquivo de configuração do Amazon Q Developer. Consulte Configuração MCP para Q Developer no IDE para mais detalhes.

O arquivo de configuração pode ser armazenado globalmente em ~/.aws/amazonq/mcp.json para ficar disponível em todos os seus projetos, ou localmente dentro do seu projeto em .amazonq/mcp.json.

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

Instalar no VS Code (Copilot)

Primeiro, habilite o suporte MCP no VS Code abrindo as Configurações (Ctrl+,), pesquisando por mcp.enabled e marcando a caixa.

Em seguida, adicione a seguinte configuração ao seu arquivo settings.json de usuário ou espaço de trabalho. Consulte a documentação MCP do VS Code para mais informações.

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

Instalar no Cursor

A maneira mais fácil de instalar é com o botão de instalação com um clique abaixo.

Alternativamente, você pode configurar manualmente o servidor adicionando o seguinte ao seu arquivo mcp.json. Este arquivo pode estar localizado globalmente em ~/.cursor/mcp.json ou dentro de um projeto específico em .cursor/mcp.json. Consulte a documentação MCP do Cursor para mais informações.

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

Instalar no Windsurf

Adicione o seguinte ao seu arquivo ~/.codeium/windsurf/mcp_config.json. Consulte a documentação MCP do Windsurf para mais informações.

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

Instalar no Zed

Você pode adicionar o servidor MCP Specifai no Zed editando seu arquivo settings.json (acessível através da ação zed: settings) ou usando a interface de configuração do Painel do Agente (agent: open configuration). Consulte a documentação MCP do Zed para mais informações.

Adicione o seguinte ao seu settings.json:

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

Ferramentas Disponíveis

O servidor fornece várias ferramentas para interagir com seus documentos de especificação:

Nome da Ferramenta	Descrição
`get-brds`	Obter Documentos de Requisitos de Negócio
`get-prds`	Obter Documentos de Requisitos de Produto
`get-nfrs`	Obter Requisitos Não Funcionais
`get-uirs`	Obter Requisitos de Interface do Usuário
`get-bpds`	Obter Documentos de Processos de Negócio
`get-tcs`	Obter Documentos de Casos de Teste
`get-user-stories`	Obter Histórias de Usuário para um PRD específico
`get-tasks`	Obter Tarefas para uma História de Usuário específica
`get-task`	Obter detalhes de uma Tarefa específica
`set-project-path`	Definir ou alterar o caminho do diretório do projeto
`get-task-by-id`	Obter detalhes de uma Tarefa específica por ID
`list-all-tasks`	Listar todas as tarefas disponíveis
`search`	Pesquisa de texto completo em todos os documentos

Contribuindo

Aceitamos contribuições para o Servidor MCP Specifai! Consulte nosso Guia de Contribuição para mais informações sobre como começar.

Configuração de Desenvolvimento

Para instruções detalhadas sobre como configurar seu ambiente de desenvolvimento, consulte nosso Guia de Configuração de Desenvolvimento.

Arquitetura

Para entender a arquitetura do projeto, consulte nosso Guia de Arquitetura.

Segurança

Para informações sobre nossa política de segurança e como reportar vulnerabilidades de segurança, consulte nossa Política de Segurança.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Agradecimentos

Model Context Protocol - A especificação do protocolo que este servidor implementa
Specifai - O projeto com o qual este servidor se integra