Mentor MCP Server

🚀 Mentor MCP Server

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

🚀 Quick Start

A server offering Model Context Protocol (MCP) services, the Mentor MCP Server uses Deep Quest Reasoning (R1) to provide second opinions to large language model agents. It covers areas like code review, design critique, writing feedback, and creative brainstorming, leveraging the Deep Quest API for expert guidance and actionable insights.

✨ Features

The Model Context Protocol (MCP) enables communication between the following components:

• Clients: MCP-compatible clients such as Claude Desktop and IDEs.
• Servers: Task management and automation tools.
• Large Language Model Agents: LLM agents that interact via MCP.

📦 Installation

# Download 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 user-input concepts 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 a 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 a 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 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 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.