Skip to main content
Glama

mentor-mcp-server

TypeScript Model Context Protocol Version License Status GitHub

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

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.


Available Tools

5 tools
brainstorm_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

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT