@mehmetsenol/gorev-mcp-server

Gorev MCP Server - Modern task management system for AI assistants via Model Context Protocol (MCP)

🇹🇷 Turkish: Task management with natural language support | 🇺🇸 English: Full bilingual support

✨ What's New in v0.16.3

Daemon Architecture - Revolutionary background process with multi-client support:

• 🔄 Single daemon serves all MCP clients (Claude, Cursor, Windsurf)
• 🚀 Auto-start on first MCP connection - zero manual setup
• 🔒 Lock file mechanism ensures single instance
• 🌐 Multi-workspace support with SHA256-based isolation
• ⚡ 30% faster startup, 15-20% memory reduction

Upgrade is automatic - NPM package now includes version-aware binary checking:

• Fresh install: Uses bundled binaries (offline support)
• Upgrade: Automatically downloads new binaries
• Best of both worlds: Offline + reliable upgrades

🚀 Quick Start

Using npx (Recommended)

No installation required! Daemon auto-starts on first MCP connection:

npx @mehmetsenol/gorev-mcp-server@latest mcp-proxy

MCP Configuration

Add to your mcp.json configuration file:

{
  "mcpServers": {
    "gorev": {
      "command": "npx",
      "args": [
        "@mehmetsenol/gorev-mcp-server@latest",
        "mcp-proxy"
      ],
      "env": {
        "GOREV_LANG": "tr"
      }
    }
  }
}

Note: The mcp-proxy command automatically starts the daemon in background if not running.

Supported MCP Clients

• ✅ Claude Desktop - AI assistant with MCP support
• ✅ VS Code - With MCP extension
• ✅ Cursor - AI-powered code editor
• ✅ Windsurf - AI development environment
• ✅ Any MCP-compatible client

🔧 Configuration Examples

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "gorev": {
      "command": "npx",
      "args": [
        "@mehmetsenol/gorev-mcp-server@latest",
        "mcp-proxy"
      ],
      "env": {
        "GOREV_LANG": "tr"
      }
    }
  }
}

VS Code

Recommended: Install the official Gorev VS Code Extension for best experience.

Alternative (MCP Extension): Add to .vscode/mcp.json:

{
  "servers": {
    "gorev": {
      "command": "npx",
      "args": [
        "@mehmetsenol/gorev-mcp-server@latest",
        "mcp-proxy"
      ],
      "env": {
        "GOREV_LANG": "en"
      }
    }
  }
}

Cursor IDE

Add to your Cursor MCP configuration:

{
  "mcpServers": {
    "gorev": {
      "command": "npx",
      "args": [
        "@mehmetsenol/gorev-mcp-server@latest",
        "mcp-proxy"
      ]
    }
  }
}

🌍 Environment Variables

| Variable | Description | Default | Values | |----------|-------------|---------|--------| | GOREV_LANG | Interface language | tr | tr, en | | GOREV_DB_PATH | Custom database path | Auto-detected | Any valid path |

📦 Installation Methods

Method 1: npx (Recommended)

# No installation needed - runs directly
npx @mehmetsenol/gorev-mcp-server@latest --help

Method 2: Global Installation

# Install globally
npm install -g @mehmetsenol/gorev-mcp-server

# Run directly
gorev-mcp --help

Method 3: Local Installation

# Install in project
npm install @mehmetsenol/gorev-mcp-server

# Run with npx
npx @mehmetsenol/gorev-mcp-server serve

🛠️ Commands

# Start MCP server (default command)
npx @mehmetsenol/gorev-mcp-server

# Initialize database
npx @mehmetsenol/gorev-mcp-server init

# Initialize with global database
npx @mehmetsenol/gorev-mcp-server init --global

# Initialize default templates
npx @mehmetsenol/gorev-mcp-server template init

# Show help
npx @mehmetsenol/gorev-mcp-server --help

# Show version
npx @mehmetsenol/gorev-mcp-server --version

✨ Features

📝 Task Management

• Natural language task creation - Create tasks by talking to AI
• Unlimited subtask hierarchy - Organize tasks in unlimited depth
• Smart status tracking - Pending → In Progress → Completed
• Priority levels - Low, Medium, High priority management
• Due date tracking - Deadline management with overdue detection

📁 Project Organization

• Hierarchical projects - Group tasks under projects
• Active project system - Quick operations with default project
• Multi-project support - Unlimited project creation
• Project-based reporting - Detailed statistics per project

🔗 Advanced Features

• Task dependencies - Link related tasks with automation
• Tagging system - Multi-tag categorization
• Template system - Pre-built task templates (Bug, Feature, etc.)
• File system watching - Auto-update tasks based on file changes
• Advanced search - Full-text search with filtering
• Data export/import - JSON/CSV export with conflict resolution

🤖 AI Integration

• 24 optimized MCP tools (unified from 45) - Complete API for AI assistants
• Natural language processing - Smart command interpretation
• Bilingual support - Turkish and English interfaces
• Cross-platform - Windows, macOS, Linux support

📊 MCP Tools Available

The server provides 24 optimized MCP tools (unified from 45 in v0.16.0) organized in categories:

• Task Management (6 tools): gorev_listele, gorev_detay, gorev_guncelle, etc.
• Subtask Management (3 tools): gorev_altgorev_olustur, etc.
• Project Management (6 tools): proje_olustur, proje_listele, etc.
• Templates (2 tools): template_listele, templateden_gorev_olustur
• Advanced Search (6 tools): gorev_search_advanced, gorev_filter_profile_*, etc.
• Data Export/Import (2 tools): gorev_export, gorev_import
• File Watching (4 tools): gorev_file_watch_add, etc.
• AI Context (6 tools): gorev_set_active, gorev_nlp_query, etc.
• IDE Extension Management (5 tools): ide_detect, ide_install_extension, etc.
• Advanced (8 tools): Various utility and management tools

🔧 Troubleshooting

Binary Download Issues

# Clear npm cache and reinstall
npm cache clean --force
npm uninstall -g @mehmetsenol/gorev-mcp-server
npm install -g @mehmetsenol/gorev-mcp-server@latest

Platform Not Supported

# Check supported platforms
npx @mehmetsenol/gorev-mcp-server --help

# Report issue with platform info
echo "Platform: $(uname -a)"

MCP Connection Issues

# Test server startup
npx @mehmetsenol/gorev-mcp-server serve

# Check database initialization
npx @mehmetsenol/gorev-mcp-server init

📱 Supported Platforms

| Platform | Architecture | Status | |----------|-------------|--------| | Windows | x64 (amd64) | ✅ | | macOS | x64 (amd64) | ✅ | | macOS | ARM64 (Apple Silicon) | ✅ | | Linux | x64 (amd64) | ✅ | | Linux | ARM64 | ✅ |

🆚 Related Packages

• VS Code Extension - Rich visual interface
• Main Repository - Source code and documentation

📚 Documentation

• Installation Guide
• MCP Tools Reference
• Development Guide
• API Documentation

🐛 Issues & Support

• Report Issues: GitHub Issues
• Feature Requests: GitHub Discussions
• Documentation: Project Wiki

📄 License

MIT License - see LICENSE file for details.

🔄 Updates

This package automatically downloads the latest Gorev binaries from GitHub releases. To update:

# Update to latest version
npm update -g @mehmetsenol/gorev-mcp-server

# Or use npx for always latest
npx @mehmetsenol/gorev-mcp-server@latest

Built with ❤️ by Mehmet Senol | Powered by Go & Model Context Protocol