Mentor (Deepseek)

by cyanheads

23 stars

354 downloads

Not rated

GitHub

About

Integrates with Deepseek API to provide AI-powered mentorship capabilities for code review, design critique, writing feedback, and idea brainstorming.

Details

Author: cyanheads
Repository: cyanheads/mentor-mcp-server
GitHub stars: 23
Downloads: 354
License: Apache License 2.0
Categories: Developer Tools, AI, Design, Workplace, File Management, Database, Frontend, Knowledge Base, API

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Mentor (Deepseek)

Command (node, npx, python, etc.) node
Arguments
- Argument 1 build/index.js
Environment
- DEEPSEEK_MODEL deepseek-reasoner
- DEEPSEEK_API_KEY your_api_key
- DEEPSEEK_TIMEOUT 30000
- DEEPSEEK_MAX_TOKENS 8192
- DEEPSEEK_MAX_RETRIES 3
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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

npm install

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

`code_review`

Conduct a comprehensive review of the specified code file. Parameters: file_path (string), language (string)

`design_critique`

Provide feedback on the design document specified. Parameters: design_document (string), design_type (string)

`writing_feedback`

Offer feedback on the provided text for improvement. Parameters: text (string), writing_type (string)

`brainstorm_enhancements`

Generate ideas for enhancing a specified feature concept. Parameters: concept (string)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

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

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.

---

<div align="center">
Built with the Model Context Protocol
</div>29:["$","div",null,{"className":"my-8 pb-8 h-full max-w-5xl mx-auto","children":["

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

code_review

design_critique

writing_feedback

brainstorm_enhancements

Claude Desktop / Cursor

Linux

Macos

Windows

mentor-mcp-server

Model Context Protocol

Table of Contents

Features

Code Analysis

Design & Architecture

Content Enhancement

Strategic Planning

Installation

Install dependencies

Build the project

Configuration

Environment Variables

Tools

Code Review

Design Critique

Writing Feedback

Feature Enhancement

Examples

Development

Start the server

Development with watch mode

Clean build artifacts

Project Structure

License

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`code_review`

`design_critique`

`writing_feedback`

`brainstorm_enhancements`