sdd-mcp-server

Servidor MCP que expoe specs e skills de um esquema de Spec-Driven Development (SDD) para qualquer cliente MCP (Claude Code, Claude Desktop, VS Code + Copilot, etc).

Estrutura

sdd-mcp-server/
├── pyproject.toml
├── server.py
├── specs/
│   └── checkout-flow.md      # exemplo de spec
└── skills/
    └── api-rest.md           # exemplo de skill

• specs/*.md — cada arquivo e uma especificacao: contrato de entrada/saida e criterios de aceite. E a fonte de verdade do que deve ser construido.

• skills/*.md — cada arquivo e um conjunto de convencoes reutilizaveis (padroes de codigo, erro, testes). Nao descreve o que construir, so o como.

Related MCP server: Omni Skills

Instalacao

Com uv (recomendado):

cd sdd-mcp-server
uv venv
uv pip install -e .

Ou com pip:

cd sdd-mcp-server
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

Rodar

python server.py

Testar com o MCP Inspector

npx @modelcontextprotocol/inspector python server.py

Isso abre uma interface web onde voce pode chamar list_specs, list_skills, get_skill, validate_spec e prepare_generation_context manualmente antes de conectar num cliente real.

Conectar ao Claude Code / Claude Desktop

No arquivo de configuracao MCP do cliente, adicione:

{
  "mcpServers": {
    "sdd-server": {
      "command": "python",
      "args": ["/caminho/absoluto/para/sdd-mcp-server/server.py"]
    }
  }
}

Conectar ao VS Code

Crie .vscode/mcp.json no seu workspace:

{
  "servers": {
    "sddServer": {
      "type": "stdio",
      "command": "python",
      "args": ["/caminho/absoluto/para/sdd-mcp-server/server.py"]
    }
  }
}

Depois, na Command Palette: MCP: List Servers → Start. Abra o Copilot Chat em Agent Mode e peca, por exemplo, "liste as specs disponiveis".

Fluxo de uso tipico

1. Escreva uma nova spec em specs/nova-feature.md seguindo o formato do exemplo checkout-flow.md (secoes ## Contrato e ## Criterios de aceite sao obrigatorias).

2. Rode a tool validate_spec para confirmar que a spec esta completa.

3. Rode list_skills para ver quais skills existem, e get_skill para ler a mais relevante.

4. Rode prepare_generation_context passando o id da spec e o dominio da skill — isso retorna um bloco de texto pronto para ser usado como prompt do agente gerador de codigo.

5. Depois do codigo gerado, escreva testes que cubram cada criterio de aceite da spec (a skill api-rest.md tem a convencao de nomenclatura).

Adicionando novas specs e skills

Basta criar novos arquivos .md em specs/ ou skills/ — o servidor os descobre automaticamente, sem precisar reiniciar codigo algum alem do proprio processo do servidor.

Solution