11 Commits

Author SHA1 Message Date
cyanheads
b95463610f docs: enhance README introduction and formatting
- Add more detailed project description
- Improve formatting and readability
- Clarify Deepseek-Reasoning (R1) capabilities
2025-01-25 20:20:19 -08:00
cyanheads
b1feec0205 docs: add comprehensive tool examples and documentation
- Create examples directory with detailed tool usage documentation
- Add example request/response for each tool
- Update main README with links to examples
- Update .gitignore to include examples directory
2025-01-25 20:17:19 -08:00
cyanheads
4a21df70ac docs: update readme with proper description and mcp tool examples 2025-01-25 19:46:20 -08:00
cyanheads
9ccd08be43 docs: add README and Apache 2.0 license 2025-01-25 19:39:55 -08:00
cyanheads
30b6f625a7 fix: resolve TypeScript errors in server implementation
- Fix tool response type compatibility with MCP SDK
- Add toolResponseToServerResult helper function
- Update server to properly convert tool responses
- Improve type safety in request handling
- Clean up error handling
2025-01-25 19:21:37 -08:00
cyanheads
0cbcdc5d01 feat: add configuration validation and examples
- Add validation for all API configuration values
- Add bounds checking for numeric values
- Add model name validation
- Update example configuration with all available options
- Add helpful error messages for invalid configuration
2025-01-25 19:19:29 -08:00
cyanheads
64cf465eb3 refactor: make all API settings configurable
- Make all Deepseek API settings configurable via MCP client config
- Add configuration validation in config.ts
- Update types to ensure type safety
- Add comprehensive example in mcp-client-config.example.json

Settings now include:
- API key and base URL
- Model selection (e.g., deepseek-reasoner)
- Max tokens (1-8192)
- Max retries
- Timeout

This change gives users more control over the server's behavior
while maintaining proper validation and defaults.
2025-01-25 19:18:09 -08:00
cyanheads
ed5afdd56c feat: upgrade to deepseek-reasoner with Chain of Thought
- Switch to deepseek-reasoner model for improved analysis
- Add Chain of Thought (CoT) reasoning capabilities
- Update types to support reasoning_content in responses
- Update second-opinion tool to showcase CoT reasoning
- Add max_tokens configuration for response length control
- Update documentation and examples

The deepseek-reasoner model provides step-by-step reasoning before
generating final responses, improving the quality and transparency
of the analysis. The reasoning is now exposed in tool responses
under the 'reasoning' field.
2025-01-25 19:14:26 -08:00
cyanheads
a6edebbf8e refactor: update Deepseek API implementation
- Switch to OpenAI SDK for Deepseek API calls
- Add openai package dependency
- Update configuration for Deepseek API
- Update environment variable examples
- Improve error handling for API responses

This change improves reliability and maintainability by using the official SDK
with proper typing and error handling.
2025-01-25 19:09:41 -08:00
cyanheads
7639395c85 feat: implement remaining MCP tools
Implements the following tools:
- code-review: Code analysis with security and performance focus
- design-critique: Design feedback for UI/UX and architecture
- writing-feedback: Writing analysis with type-specific criteria
- brainstorm-enhancements: Creative improvement suggestions

Each tool includes:
- Type-safe implementation
- Comprehensive error handling
- Input validation and sanitization
- Rate limiting
- Structured prompts
- Clear documentation

Updates:
- Server implementation to support all tools
- Type definitions for all tool arguments
- Type guards for argument validation
2025-01-25 19:03:07 -08:00
cyanheads
8968a96a98 feat: Initial implementation of mentor-mcp-server
Implements a Model Context Protocol (MCP) server that provides AI-powered mentorship and feedback tools.

Core Features:
- TypeScript implementation with ES modules
- MCP server setup with stdio transport
- Deepseek API integration with rate limiting and retry logic
- Secure environment configuration management
- Comprehensive utility functions for file and prompt handling

Tools:
- second-opinion: Provides critical analysis of user requests
  - Input validation
  - Rate limiting
  - Error handling
  - Sanitized inputs
  - Structured prompt templates

Infrastructure:
- Atomic design directory structure
- Type-safe implementation
- Proper error handling
- Security measures (input sanitization, rate limiting)
- Development scripts and configuration

Security Features:
- API key protection
- Input sanitization
- Rate limiting
- Error message sanitization
- Secure file path validation

This implementation follows MCP best practices and provides a foundation for adding additional tools:
- code-review
- design-critique
- writing-feedback
- brainstorm-enhancements
2025-01-25 18:58:47 -08:00