Mentor MCP Server

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

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

# 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:

{
  "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"
      }
    }
  }
}

Environment Variables

Variable	Required	Default	Description
DEEPSEEK_API_KEY	Yes	-	Your Deepseek API key
DEEPSEEK_MODEL	Yes	deepseek-reasoner	Deepseek model name
DEEPSEEK_MAX_TOKENS	No	8192	Maximum tokens per request
DEEPSEEK_MAX_RETRIES	No	3	Number of retry attempts
DEEPSEEK_TIMEOUT	No	30000	Request timeout (ms)

Tools

Code Review

<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>

Design Critique

<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>

Writing Feedback

<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>

Feature Enhancement

<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>

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
Design Critique Example - Comprehensive UI/UX feedback for a dashboard design
Writing Feedback Example - Documentation improvement suggestions
Brainstorm Enhancements Example - Feature ideation with implementation details

Each example includes the request format and sample response, demonstrating the tool's capabilities and output structure.

Development

# 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

Project Structure

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

License

Apache License 2.0. See LICENSE for more information.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Provides LLM Agents with AI-powered mentorship for code review, design critique, writing feedback, and brainstorming using the Deepseek API, enabling enhanced output in various development and strategic planning tasks.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Deepseek Thinker MCP Server
ruixingshi
A
security
F
license
A
quality
Provides reasoning content to MCP-enabled AI clients by interfacing with Deepseek's API or a local Ollama server, enabling focused reasoning and thought process visualization.
Last updated -
1
54
24
JavaScript
DeepSeek MCP Server
Sheshiyer
-
security
F
license
-
quality
Provides code generation and completion capabilities using the DeepSeek API, with support for tool chaining and cost optimization.
Last updated -
3
JavaScript
Chain of Draft Thinking
bsmi021
A
security
A
license
A
quality
Chain of Draft Server is a powerful AI-driven tool that helps developers make better decisions through systematic, iterative refinement of thoughts and designs. It integrates seamlessly with popular AI agents and provides a structured approach to reasoning, API design, architecture decisions, code r
Last updated -
1
6
7
TypeScript
MIT License
LLM Gateway MCP Server
Dicklesworthstone
-
security
A
license
-
quality
An MCP-native server that enables intelligent task delegation from advanced AI agents like Claude to more cost-effective LLMs, optimizing for cost while maintaining output quality.
Last updated -
64
Python
MIT License

View all related MCP servers

Mentor MCP Server