Project Handoffs

Servidor MCP de Project Handoffs

Servidor MCP para gerenciar transferências de sessões de IA e rastreamento de próximos passos.

Conceitos Principais

• NextStep → WorkingSession → Handoff → Nova cadeia de NextStep
• Organização baseada em projetos
• Níveis de prioridade mapeados para impacto na implementação:
  • core-critical: Crítico para implementação funcional
  • full-required: Necessário para a implementação desejada
  • enhancement: Melhorias e otimizações

Ferramentas Disponíveis

• list_templates - Listar modelos disponíveis para próximos passos, sessões de trabalho e transferências
• create_project - Criar um novo projeto para rastrear transferências de sessões de IA
• delete_project - Excluir um projeto e todos os seus dados
• create_next_step - Criar um novo próximo passo em um projeto
• start_working_session - Iniciar o trabalho em um próximo passo
• create_handoff - Concluir uma sessão de trabalho com detalhes de transferência
• get_latest_next_steps - Obter próximos passos abertos ordenados por prioridade
• get_next_step_history - Obter histórico completo de um próximo passo, incluindo sessão e transferência

Instalação

npm install
npm run build

Configuração

Adicione à sua configuração MCP:

{
  "mcpServers": {
    "project-handoffs": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/path/to/project-handoffs/build/index.js"],
      "alwaysAllow": []
    }
  }
}

Estrutura do Projeto

project-handoffs/
├── src/
│   ├── index.ts           # Server implementation
│   ├── templates.ts       # Entity templates
│   ├── types.ts          # TypeScript types
│   └── errors.ts         # Error handling
├── package.json          
└── README.md

Desenvolvimento

# Instalar dependências
npm install

# Modo de desenvolvimento
npm run dev

# Compilar
npm run build


## Detalhes de Implementação

- Tratamento de erros por meio da classe ProjectError
- Validação de modelos para todos os tipos de entidades
- Gerenciamento consistente de estado
- Persistência segura de dados com tratamento adequado de erros
- Implementação type-safe seguindo os padrões do project-memory-server

## Segurança

Se você descobrir uma vulnerabilidade de segurança, crie uma nova issue com o rótulo 'security'. Levamos todos os relatórios de segurança a sério e responderemos prontamente.

## Contribuição

Contribuições são bem-vindas. Sinta-se à vontade para enviar um Pull Request.

## Licença

Este projeto é licenciado sob a Apache License 2.0 - consulte o arquivo [LICENSE](LICENSE) para obter detalhes.