Mentor MCP Server

🚀 Mentor MCP Server

A server that provides Model Context Protocol (MCP) services, offering second opinions to large language model agents through the Deep Quest Reasoning (R1) capability. It includes code reviews, design critiques, writing feedback, and creative brainstorming, leveraging the Deep Quest API to deliver expert-level guidance and actionable insights.

✨ Features

• Model Context Protocol (MCP): Enables communication between clients (e.g., Claude Desktop, MCP-compatible IDEs), servers (task management and automation tools), and large language model agents.
• Multiple Tools: Offers various tools such as Second Opinion, Code Review, Design Critique, and Function Enhancement to provide valuable suggestions and insights.

📦 Installation

# Clone the project
git clone https://github.com/cyanheads/mentor-mcp-server.git

# Navigate to the directory
cd mentor-mcp-server

# Install dependencies
npm install

📚 Documentation

Configuration

Create a config.json file in the project's root directory with the following content:

{
  "port": 3000,
  "api_key": "your_api_key_here",
  "debug_mode": false
}

Tool Usage

Second Opinion Tool

Analyzes the user-input concept and provides improvement suggestions:

Request Format

<request>
  <tool>second-opinion</tool>
  <concept>User authentication system</concept>
</request>

Response Example

{
  "suggestions": [
    "Implement multi-factor authentication for enhanced security.",
    "Consider integrating social login options for better user experience."
  ],
  "rationale": "A robust authentication system should include multiple layers of security and flexible login methods."
}

Code Review Tool

Conducts a detailed review of the given code snippet:

Request Format

<request>
  <tool>code-review</tool>
  <code>function example() { console.log("Hello World"); }</code>
</request>

Response Example

{
  "issues": [],
  "quality_score": 100,
  "review_notes": "A simple and clean function with no apparent issues."
}

Design Critique Tool

Evaluates the given design sketch and provides suggestions:

Request Format

<request>
  <tool>design-critique</tool>
  <description>A new user dashboard layout</description>
</request>

Response Example

{
  "comments": [
    "Consider adding more whitespace for better visual hierarchy.",
    "The color scheme could be more accessible."
  ],
  "rating": 85
}

Function Enhancement Tool

Brainstorms ideas for enhancing specific functions:

Request Format

<request>
  <tool>brainstorm-enhancements</tool>
  <concept>Task management feature</concept>
</request>

Response Example

{
  "ideas": [
    "Add drag-and-drop functionality for better usability.",
    "Implement priority levels for tasks."
  ],
  "benefits": "These enhancements can improve user productivity and task organization."
}

Development Guide

Project Structure

src/
├── api/         # API interface module
├── tools/       # Tool implementation
│   ├── second-opinion/
│   ├── code-review/
│   ├── design-critique/
│   ├── writing-feedback/
│   └── brainstorm-enhancements/
├── types/       # TypeScript type definitions
├── utils/       # Utility functions
├── config.ts    # Server configuration
├── index.ts     # Entry file
└── server.ts    # Main server implementation

Command Line Operations

# Build the project
npm run build

# Start the server
npm run start

# Start in development mode
npm run dev

# Clean build artifacts
npm run clean

📄 License

This project is licensed under the Apache License 2.0. For more details, please refer to the LICENSE file.