SAGE-MCP v0.1.0-beta - Initial Release

🧙 SAGE-MCP v0.1.0-beta

Initial beta release of Simple AI Guidance Engine for Claude

✨ Highlights

SAGE-MCP is a complete rewrite of zen-mcp-server, reducing complexity by 75% while adding revolutionary features. One universal tool replaces 17 specialized tools, providing a cleaner, more maintainable solution.

🚀 Key Features

Intelligent Mode System

• 8 specialized modes: chat, analyze, review, debug, plan, test, refactor, think
• Each mode optimized with specific temperatures and prompts
• Seamless switching between modes within conversations

Conversation Continuity

• Multi-turn conversations across different modes
• Automatic context preservation between tool calls
• Smart file deduplication - never re-reads the same files
• Thread-based memory system for long-running tasks

Smart Model Selection

• Auto mode intelligently selects models based on task complexity
• Support for OpenAI, Anthropic, Google, OpenRouter providers
• Model restrictions via environment variables for cost control
• Adjustable thinking depth: minimal to maximum

Intelligent File Handling

• Three modes: embedded (full content), summary (token-efficient), reference (ID-based)
• Automatic directory expansion
• Smart deduplication across conversation turns
• Security validation for all file operations

Web Search Integration

• Real-time documentation lookup
• Best practices and current standards research
• Framework and library investigation
• Error and issue analysis

📦 Installation

```bash
git clone https://github.com/david-strejc/sage-mcp
cd sage-mcp
pip install -r requirements.txt
```

⚙️ Configuration

Add to your Claude Desktop MCP settings:

```json
{
"mcpServers": {
"sage": {
"command": "python",
"args": ["/path/to/sage-mcp/server.py"],
"env": {
"OPENAI_API_KEY": "your-key",
"ANTHROPIC_API_KEY": "your-key",
"DEFAULT_MODEL": "gpt-4o"
}
}
}
}
```

🎯 Usage Example

```typescript
// Basic usage in Claude
Use sage tool to explain async/await in Python

// Code analysis
Use sage in analyze mode to review ./src/api/

// Continue conversation
Use sage to help design a caching system
// Then continue with implementation...
```

📊 Improvements Over zen-mcp

• 94% reduction in tool count (17 → 1)
• 70% reduction in code size (~4000 → ~1200 lines)
• New features: Conversation memory, file deduplication, smart model selection
• Enhanced: Model restrictions, dynamic schemas, maintenance simplicity

⚠️ Beta Notice

This is a beta release. While fully functional, please report any issues or suggestions via GitHub Issues.

📄 License

MIT License

---

Full documentation: https://github.com/david-strejc/sage-mcp