Houtini-lm

# Houtini LM - LM Studio MCP Server with Expert Prompt Library and Custom Prompting **Your unlimited AI companion: This MCP server connects Claude to LM Studio for code analysis, generation, and creativity** Transform your development workflow with our expert-level prompt library for code analysis, professional documentation generation, and creative project scaffolding - all running locally without API costs. For developers, vibe coders and creators alike. ## What This Does Houtini LM **saves your Claude context window** by offloading detailed analysis tasks to LM Studio locally or on your company network whilst Claude focuses on strategy and complex problem-solving. Think of it as your intelligent coding assistant that never runs out of tokens. **Perfect for:** - 🔍 **Code analysis** - Deep insights into quality, security, and architecture - 📝 **Documentation generation** - Professional docs from code analysis - 🏗️ **Project scaffolding** - Complete applications, themes, and components - 🎮 **Creative projects** - Games, CSS art, and interactive experiences - 🛡️ **Security audits** - OWASP compliance and vulnerability detection ## Quick Start Prompt Guide Once installed, simply use natural language prompts with Claude: ``` Use houtini-lm to analyse the code quality in C:/my-project/src/UserAuth.js ``` ``` Generate comprehensive unit tests using houtini-lm for my React component at C:/components/Dashboard.jsx ``` ``` Use houtini-lm to create a WordPress plugin called "Event Manager" with custom post types and admin interface ``` ``` Audit the security of my WordPress theme using houtini-lm at C:/themes/my-theme ``` ``` Create a CSS art generator project using houtini-lm with space theme and neon colours ``` ``` Use houtini-lm to convert my JavaScript file to TypeScript with strict mode enabled ``` ``` Generate responsive HTML components using houtini-lm for a pricing card with dark mode support ``` ## Prerequisites **Essential Requirements:** 1. **LM Studio** - Download from [lmstudio.ai](https://lmstudio.ai) - Must be running at `ws://127.0.0.1:1234` - Model loaded and ready (13B+ parameters recommended) 2. **Desktop Commander MCP** - Essential for file operations - Repository: [DesktopCommanderMCP](https://github.com/wonderwhy-er/DesktopCommanderMCP) - Required for reading files and writing generated code 3. **Node.js 24.6.0 or later** - For MCP server functionality - Download from [nodejs.org](https://nodejs.org) 4. **Claude Desktop** - For the best experience - Download from [claude.ai/download](https://claude.ai/download) ## Installation ### 1. Install the Package ```bash # Install globally via npm npm install -g @houtini/lm # Or use npx (no installation required) npx @houtini/lm ``` ### 2. Configure Claude Desktop Add to your Claude Desktop configuration file: **Windows**: `%APPDATA%/Claude/claude_desktop_config.json` **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` ```json { "mcpServers": { "houtini-lm": { "command": "npx", "args": ["@houtini/lm"], "env": { "LLM_MCP_ALLOWED_DIRS": "C:/your-projects,C:/dev,C:/websites" } } } } ``` ### 3. Start LM Studio 1. Launch LM Studio 2. Load a model (13B+ parameters recommended for best results) 3. Start the server at `ws://127.0.0.1:1234` 4. Verify the model is ready and responding ### 4. Verify Installation Restart Claude Desktop, then test with: ``` Use houtini-lm health check to verify everything is working ``` ## Available Functions ### 🔍 Analysis Functions (17 functions) - **`analyze_single_file`** - Deep code analysis and quality assessment - **`count_files`** - Project structure with beautiful markdown trees - **`find_unused_files`** - Dead code detection with risk assessment - **`security_audit`** - OWASP compliance and vulnerability scanning - **`analyze_dependencies`** - Circular dependencies and unused imports - And 12 more specialized analysis tools... ### 🛠️ Generation Functions (10 functions) - **`generate_unit_tests`** - Comprehensive test suites with framework patterns - **`generate_documentation`** - Professional docs from code analysis - **`convert_to_typescript`** - JavaScript to TypeScript with type safety - **`generate_wordpress_plugin`** - Complete WordPress plugin creation - **`generate_responsive_component`** - Accessible HTML/CSS components - And 5 more generation tools... ### 🎮 Creative Functions (3 functions) - **`css_art_generator`** - Pure CSS art and animations - **`arcade_game`** - Complete playable HTML5 games - **`create_text_adventure`** - Interactive fiction with branching stories ### ⚙️ System Functions (5 functions) - **`health_check`** - Verify LM Studio connection - **`list_functions`** - Discover all available functions - **`resolve_path`** - Path analysis and suggestions - And 2 more system utilities... ## Context Window Management Houtini LM implements intelligent context window management to maximize the efficiency of your local LM models while ensuring reliable processing of large files and complex analysis tasks. ### Dynamic Context Allocation **Adaptive Context Utilization**: Unlike systems with hardcoded token limits, Houtini LM dynamically detects your model's context window and allocates **95% of available tokens** for optimal performance: ```typescript // Context detection from your loaded model const contextLength = await model.getContextLength(); // e.g., 16,384 tokens // Dynamic allocation - 95% utilization const responseTokens = Math.floor(contextLength * 0.95); // 15,565 tokens available ``` **Benefits:** - ✅ **Maximum efficiency** - No wasted context space - ✅ **Model-agnostic** - Works with any context size (4K, 16K, 32K+) - ✅ **Future-proof** - Automatically adapts to larger models ### Three-Stage Prompt System Houtini LM uses a sophisticated prompt architecture that separates concerns for optimal token management: **Stage 1: System Context** - Expert persona and analysis methodology **Stage 2: Data Payload** - Your code, files, or project content **Stage 3: Output Instructions** - Structured response requirements ``` ┌─────────────────────┐ │ System Context │ ← Expert role, methodologies ├─────────────────────┤ │ Data Payload │ ← Your files/code (chunked if needed) ├─────────────────────┤ │ Output Instructions │ ← Response format, requirements └─────────────────────┘ ``` **Intelligent Processing:** - **Small files** → Single-stage execution for speed - **Large files** → Automatic chunking with coherent aggregation - **Multi-file projects** → Optimized batch processing ### Automatic Chunking Capability When files exceed available context space, Houtini LM automatically chunks content while maintaining analysis quality: **Smart Chunking Features:** - 🔍 **Natural boundaries** - Splits at logical sections, not arbitrary points - 🔄 **Context preservation** - Maintains analysis continuity across chunks - 📊 **Intelligent aggregation** - Combines chunk results into coherent reports - ⚡ **Performance optimization** - Parallel processing where possible **Example Chunking Process:** ``` Large File (50KB) → Context Analysis → Exceeds Limit ↓ Split into 3 logical chunks → Process each chunk → Aggregate results ↓ Single comprehensive analysis report ``` ### Timeout Configuration Houtini LM uses **120-second timeouts** (2 minutes) to accommodate thorough analysis on lower-powered systems: **Why Extended Timeouts:** - 🔍 **Complex analysis** - Security audits, architecture analysis, and comprehensive code reviews take time - 💻 **System compatibility** - Works reliably on older hardware and resource-constrained environments - 🧠 **Model processing** - Larger local models (13B-33B parameters) require more inference time - 📊 **Quality over speed** - Comprehensive reports are worth the wait **Timeout Guidelines:** - **Simple analysis** (100 lines): 15-30 seconds - **Medium files** (500 lines): 30-60 seconds - **Large files** (1000+ lines): 60-120 seconds - **Multi-file projects**: 90-180 seconds **Performance Tips:** - Use faster models (13B vs 33B) for quicker responses - Enable GPU acceleration in LM Studio for better performance - Consider using `analysisDepth="basic"` for faster results when appropriate ### Memory Efficiency **Intelligent Caching**: Results are cached to prevent redundant processing **Resource Management**: Automatic cleanup of large contexts after processing **Streaming Responses**: Progressive output delivery for better user experience This architecture ensures Houtini LM can handle everything from small utility functions to entire enterprise codebases while maintaining consistent quality and performance across different hardware configurations. ## Documentation **Complete guides available:** - [Analysis Functions Guide](docs/analysis-functions-md.md) - All 17 analysis tools - [Generation Functions Guide](docs/generation-functions-md.md) - All 10 creation tools - [Creative Functions Guide](docs/creative-functions-md.md) - Games and art tools - [System Functions Guide](docs/system-functions-md.md) - Utilities and diagnostics - [Complete User Guide](docs/user-guide-md.md) - Comprehensive usage manual ## Recommended Setup **For Professional Development:** - **CPU**: 8-core or better (for local LLM processing) - **RAM**: 32GB (24GB for model, 8GB for development) - **Storage**: SSD with 100GB+ free space - **Model**: Qwen2.5-Coder-14B-Instruct or similar **Performance Tips:** - Use 13B+ parameter models for professional-quality results - Configure `LLM_MCP_ALLOWED_DIRS` to include your project directories - Install Desktop Commander MCP for complete file operation support - Keep LM Studio running and model loaded for instant responses ## Version History ### Version 1.0.0 (Current) - ✅ Complete function library (35+ functions) - ✅ Professional documentation system - ✅ WordPress-specific tools and auditing - ✅ Creative project generators - ✅ Comprehensive security analysis - ✅ TypeScript conversion and test generation - ✅ Cross-file integration analysis ## License **MIT License** - Use this project freely for personal and commercial projects. See [LICENSE](LICENSE) for details. ## Contributing We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on: - Code standards and patterns - Testing requirements - Documentation updates - Issue reporting ## Support - **Issues**: [GitHub Issues](https://github.com/houtini-ai/lm/issues) - **Discussions**: [GitHub Discussions](https://github.com/houtini-ai/lm/discussions) - **Documentation**: Complete guides in the `docs/` directory --- **Ready to supercharge your development workflow?** Install Houtini LM and start building amazing things with unlimited local AI assistance. *Built for developers who think clearly but can't afford to think expensively.*