cyanheads/mentor-mcp-server

A Model Context Protocol server providing LLM Agents a second opinion via AI-powered Deepseek-Reasoning (R1) mentorship capabilities, including code review, design critique, writing feedback, and idea brainstorming through the Deepseek API. Set your LLM Agent up for success with expert second opinions and actionable insights.
## Model Context Protocol
The Model Context Protocol (MCP) enables communication between:
Clients: Claude Desktop, IDEs, and other MCP-compatible clients
Servers: Tools and resources for task management and automation
LLM Agents: AI models that leverage the server's capabilities
## Table of Contents
Features
Installation
Configuration
Tools
Examples
Development
Project Structure
License
## Features
### Code Analysis
Comprehensive code reviews
Bug detection and prevention
Style and best practices evaluation
Performance optimization suggestions
Security vulnerability assessment
### Design & Architecture
UI/UX design critiques
Architectural diagram analysis
Design pattern recommendations
Accessibility evaluation
Consistency checks
### Content Enhancement
Writing feedback and improvement
Grammar and style analysis
Documentation review
Content clarity assessment
Structural recommendations
### Strategic Planning
Feature enhancement brainstorming
Second opinions on approaches
Innovation suggestions
Feasibility analysis
User value assessment
## Installation
bash
# 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
## Configuration
Add to your MCP client settings:
json
"mcpServers": {
"mentor": {
"command": "node",
"args": ["build/index.js"],
"env": {
"DEEPSEEKAPIKEY": "yourapikey",
"DEEPSEEKMODEL": "deepseek-reasoner",
"DEEPSEEKMAXTOKENS": "8192",
"DEEPSEEKMAXRETRIES": "3",
"DEEPSEEKTIMEOUT": "30000"
### Environment Variables
| Variable | Required | Default | Description |
| DEEPSEEKAPIKEY | Yes | - | Your Deepseek API key |
| DEEPSEEKMODEL | Yes | deepseek-reasoner | Deepseek model name |
| DEEPSEEKMAXTOKENS | No | 8192 | Maximum tokens per request |
| DEEPSEEKMAXRETRIES | No | 3 | Number of retry attempts |
| DEEPSEEKTIMEOUT | No | 30000 | Request timeout (ms) |
## Tools
### Code Review
xml
mentor-mcp-server
codereview
"filepath": "src/app.ts",
"language": "typescript"
### Design Critique
xml
mentor-mcp-server
designcritique
"designdocument": "path/to/design.fig",
"designtype": "web UI"
### Writing Feedback
xml
mentor-mcp-server
writingfeedback
"text": "Documentation content...",
"writingtype": "documentation"
### Feature Enhancement
xml
mentor-mcp-server
brainstormenhancements
"concept": "User authentication system"
## Examples
Detailed examples of each tool's usage and output can be found in the examples directory:
Second Opinion Example - Analysis of authentication system requirements
Code Review Example - Detailed TypeScript code review with security and performance insights