mentor-mcp-server
The Mentor MCP Server provides AI-powered mentorship capabilities through the Deepseek API using the Model Context Protocol. It offers:
Second Opinions: Analyzes user requests and lists critical considerations
Code Reviews: Identifies bugs, style issues, performance bottlenecks, and security vulnerabilities
Design Critiques: Evaluates UI/UX mockups, architectural diagrams for usability and accessibility
Writing Feedback: Assesses clarity, grammar, style, and structure
Brainstorm Enhancements: Generates creative ideas for improving concepts, products, or features
The MCP server mentions support for Fig design files in the design critique tool
The MCP server supports integration with Git for cloning the repository
The MCP server is hosted on GitHub and references GitHub in its badges
The MCP server uses npm for package management and running development commands
The MCP server is built with TypeScript and provides code review functionality for TypeScript code
The MCP server uses XML format for tool invocation syntax in the Model Context Protocol
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mentor-mcp-server review this TypeScript function for bugs and best practices"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: DSH Crew
Table of Contents
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 buildConfiguration
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 cleanProject 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 implementationLicense
Apache License 2.0. See LICENSE for more information.
Available Tools
5 toolsbrainstorm_enhancementsC
Generates creative ideas for improving a given concept, product, or feature, focusing on innovation, feasibility, and user value.
Inputs: concept (required).
code_reviewC
Provides a code review for a given file or code snippet, focusing on potential bugs, style issues, performance bottlenecks, and security vulnerabilities.
Inputs: file_path, language, code_snippet.
design_critiqueB
Offers a critique of a design document, UI/UX mockup, or architectural diagram, focusing on usability, aesthetics, consistency, accessibility, and potential design flaws.
Inputs: design_document (required), design_type (required).
second_opinionC
Provides a second opinion on a user's request by analyzing it with an LLM and listing critical considerations.
Inputs: user_request (required).
writing_feedbackC
Provides feedback on a piece of writing, such as an essay, article, or technical documentation, focusing on clarity, grammar, style, structure, and overall effectiveness.
Inputs: text (required), writing_type (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose targeting different domains: brainstorming, code review, design critique, second opinions, and writing feedback. There is no overlap in functionality, making it easy for an agent to select the appropriate tool without confusion.
All tool names follow a consistent snake_case pattern with a clear verb_noun structure (e.g., brainstorm_enhancements, code_review). This predictability enhances usability and aligns with common MCP conventions.
With 5 tools, the server is well-scoped for its mentoring/feedback purpose. Each tool serves a unique and valuable function, avoiding bloat while covering key areas like code, design, writing, and idea generation.
The toolset covers major feedback domains (code, design, writing, brainstorming) and includes a general second_opinion tool. A minor gap is the lack of a tool for project management or strategic planning feedback, but core mentoring workflows are well-supported.
Maintenance
Related MCP Connectors
A design agent in your coding agent's loop: briefs each screen, reviews UX and visual quality.
DevSpeak is a writing tool for developers, available to your coding agent over MCP. Call `optimize_text` to improve a PR description, commit message, ticket or doc in the language it was written in, or set `correctionsOnly` to fix only spelling, grammar and punctuation. Call `translate_text` to turn rough notes into a technical spec, Jira tickets, an RFC, an API design or a data model for the audience you choose (Junior Dev, Senior Dev, Tech Lead, SRE or Data Engineer). It also translates README files with `translate_markdown`, refines earlier output and lists your history. Requires a DevSpeak API key; a free account includes one key with 50 API requests a month.
AI colleagues that keep your standards, your project and their reasoning between sessions
Memory, reflection and safety for AI agents. Hosted or local, no vector database.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides code generation and completion capabilities using the DeepSeek API, with support for tool chaining and cost optimization.5ISC
- AlicenseNot gradedqualityAmaintenanceEnables dispatching tasks from coding hosts such as Claude Code, Codex, Antigravity and Grok to DeepSeek Harness agents that appear as native subagents with live progress, tier/effort policy, escalation, and workspace guardrails. Also lends text-only harnesses vision and image generation through DeepSeek VL models or existing CLIs.354 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables coding hosts like Claude Code, Codex, Antigravity and Grok to dispatch work to DeepSeek Harness agents that appear as native subagents with live progress, tier/effort policy, escalation on failure, workspace guardrails and a jobs board. Also lends text-only harnesses vision and image generation via DeepSeek's VL model, the host's existing CLIs, or custom OpenAI-compatible endpoints.354 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables hosts like Claude Code, Codex, Antigravity and Grok to dispatch tasks to DeepSeek Harness agents while still showing them as native subagents with live progress, tier/effort presets, escalation, dispatch guardrails and a jobs board. Also lends text-only harnesses vision and image generation through DeepSeek's VL model or existing CLIs and custom OpenAI-compatible endpoints.354 npmMIT