ve 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 performance insights - [Design Critique Example](examples/design-critique.md) - Comprehensive UI/UX feedback for a dashboard design - [Writing Feedback Example](examples/writing-feedback.md) - Documentation improvement suggestions - [Brainstorm Enhancements Example](examples/brainstorm-enhancements.md) - Feature ideation with implementation details Each example includes the request format and sample response, demonstrating the tool's capabilities and output structure. ## Development ```bash # 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

mentor-mcp-server

Comments