us](https://img.shields.io/badge/Status-Stable-blue.svg)]() [![GitHub](https://img.shields.io/github/stars/cyanheads/mentor-mcp-server?style=social)](https://github.com/cyanheads/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 ## Table of Contents - [Features](#features) - [Installation](#installation) - [Configuration](#configuration) - [Tools](#tools) - [Examples](#examples) - [Development](#development) - [Project Structure](#project-structure) - [License](#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 ```bash # 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: ```json { "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 ```xml mentor-mcp-server code_review { "file_path": "src/app.ts", "language": "typescript" } ``` ### Design Critique ```xml mentor-mcp-server design_critique { "design_document": "path/to/design.fig", "design_type": "web UI" } ``` ### Writing Feedback ```xml mentor-mcp-server writing_feedback { "text": "Documentation content...", "writing_type": "documentation" } ``` ### Feature Enhancement ```xml mentor-mcp-server brainstorm_enhancements { "concept": "User authentication system" } ``` ## Examples Detailed examples of each tool's usage and output can be found in the [examples](examples) directory: - [Second Opinion Example](examples/second-opinion.md) - Analysis of authentication system requirements - [Code Review Example](examples/code-review.md) - Detailed TypeScript code review with security and perf

#mentor-mcp-server

mentor-mcp-server