Mentor MCP

mentor-mcp-server

Um servidor Model Context Protocol que fornece aos Agentes LLM uma segunda opinião por meio de capacidades de mentoria alimentadas por IA Deepseek-Reasoning (R1), incluindo revisão de código, crítica de design, feedback de escrita e brainstorming de ideias através da API Deepseek. Prepare seu Agente LLM para o sucesso com segundas opiniões de especialistas e insights acionáveis.

Model Context Protocol

O Model Context Protocol (MCP) permite a comunicação entre:

• Clients: Claude Desktop, IDEs e outros clientes compatíveis com MCP
• Servers: Ferramentas e recursos para gerenciamento de tarefas e automação
• LLM Agents: Modelos de IA que aproveitam as capacidades do servidor

Sumário

• Recursos
• Instalação
• Configuração
• Ferramentas
• Exemplos
• Desenvolvimento
• Estrutura do Projeto
• Licença

Recursos

Análise de Código

• Revisões abrangentes de código
• Detecção e prevenção de bugs
• Avaliação de estilo e boas práticas
• Sugestões de otimização de desempenho
• Avaliação de vulnerabilidades de segurança

Design e Arquitetura

• Críticas de design de UI/UX
• Análise de diagramas arquiteturais
• Recomendações de padrões de design
• Avaliação de acessibilidade
• Verificações de consistência

Melhoria de Conteúdo

• Feedback de escrita e melhorias
• Análise de gramática e estilo
• Revisão de documentação
• Avaliação de clareza do conteúdo
• Recomendações estruturais

Planejamento Estratégico

• Brainstorming de melhorias de recursos
• Segundas opiniões sobre abordagens
• Sugestões de inovação
• Análise de viabilidade
• Avaliação de valor para o usuário

Instalação

# Clone the repository
git clone git@github.com:cyanheads/mentor-mcp-server.git
cd mentor-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuração

Adicione às configurações do seu cliente MCP:

{
  "mcpServers": {
    "mentor": {
      "command": "node",
      "args": ["build/index.js"],
      "env": {
        "DEEPSEEK_API_KEY": "your_api_key",
        "DEEPSEEK_MODEL": "deepseek-reasoner",
        "DEEPSEEK_MAX_TOKENS": "8192",
        "DEEPSEEK_MAX_RETRIES": "3",
        "DEEPSEEK_TIMEOUT": "30000"
      }
    }
  }
}

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
DEEPSEEK_API_KEY	Sim	-	Sua chave da API Deepseek
DEEPSEEK_MODEL	Sim	deepseek-reasoner	Nome do modelo Deepseek
DEEPSEEK_MAX_TOKENS	Não	8192	Máximo de tokens por solicitação
DEEPSEEK_MAX_RETRIES	Não	3	Número de tentativas de nova solicitação
DEEPSEEK_TIMEOUT	Não	30000	Tempo limite da solicitação (ms)

Ferramentas

Revisão de Código

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>code_review</tool_name>
<arguments>
{
  "file_path": "src/app.ts",
  "language": "typescript"
}
</arguments>
</use_mcp_tool>

Crítica de Design

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>design_critique</tool_name>
<arguments>
{
  "design_document": "path/to/design.fig",
  "design_type": "web UI"
}
</arguments>
</use_mcp_tool>

Feedback de Escrita

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>writing_feedback</tool_name>
<arguments>
{
  "text": "Documentation content...",
  "writing_type": "documentation"
}
</arguments>
</use_mcp_tool>

Melhoria de Recursos

<use_mcp_tool>
<server_name>mentor-mcp-server</server_name>
<tool_name>brainstorm_enhancements</tool_name>
<arguments>
{
  "concept": "User authentication system"
}
</arguments>
</use_mcp_tool>

Exemplos

Exemplos detalhados do uso e da saída de cada ferramenta podem ser encontrados no diretório exemplos:

• Exemplo de Segunda Opinião - Análise dos requisitos do sistema de autenticação
• Exemplo de Revisão de Código - Revisão detalhada de código TypeScript com insights de segurança e desempenho
• Exemplo de Crítica de Design - Feedback abrangente de UI/UX para um design de dashboard
• Exemplo de Feedback de Escrita - Sugestões de melhoria de documentação
• Exemplo de Brainstorming de Melhorias - Ideação de recursos com detalhes de implementação

Cada exemplo inclui o formato da solicitação e a resposta de exemplo, demonstrando as capacidades da ferramenta e a estrutura da saída.

Desenvolvimento

# Build TypeScript code
npm run build

# Start the server
npm run start

# Development with watch mode
npm run dev

# Clean build artifacts
npm run clean

Estrutura do Projeto

src/
├── api/         # API integration modules
├── tools/       # Tool implementations
│   ├── second-opinion/
│   ├── code-review/
│   ├── design-critique/
│   ├── writing-feedback/
│   └── brainstorm-enhancements/
├── types/       # TypeScript type definitions
├── utils/       # Utility functions
├── config.ts    # Server configuration
├── index.ts     # Entry point
└── server.ts    # Main server implementation

Licença

Licença Apache 2.0. Consulte LICENSE para mais informações.

---