devgenius-mcp-client 1.2.0

DevGenius MCP Client for AI IDEs

DevGenius MCP Client

DevGenius MCP Client for AI IDEs (Cursor, Windsurf, Trae, etc.)

🚀 Quick Start with uvx

无需安装，一条命令运行！

uvx devgenius-mcp-client

📦 Installation Methods

Method 1: uvx (Recommended) ⭐

优点:

• ✅ 无需预安装依赖
• ✅ 自动创建隔离环境
• ✅ 一条命令运行

# 直接运行（uvx 会自动安装依赖）
uvx devgenius-mcp-client

Method 2: pip

pip install devgenius-mcp-client
devgenius-mcp

Method 3: pipx

pipx install devgenius-mcp-client
devgenius-mcp

🔧 AI IDE Configuration

Trae IDE

{
  "mcpServers": {
    "devgenius": {
      "command": "uvx",
      "args": ["devgenius-mcp-client"],
      "env": {
        "DEVGENIUS_MCP_TOKEN": "mcp_你的Token",
        "DEVGENIUS_API_URL": "http://localhost:8000/api/v1/mcp"
      }
    }
  }
}

Cursor IDE

{
  "mcp": {
    "servers": {
      "devgenius": {
        "command": "uvx",
        "args": ["devgenius-mcp-client"],
        "env": {
          "DEVGENIUS_MCP_TOKEN": "mcp_你的Token",
          "DEVGENIUS_API_URL": "http://localhost:8000/api/v1/mcp"
        }
      }
    }
  }
}

Windsurf IDE

Same as Cursor.

🌐 Environment Variables

Required

• DEVGENIUS_MCP_TOKEN - Your MCP Token (required)
• DEVGENIUS_API_URL - API URL (default: http://localhost:8000/api/v1/mcp)

Optional (Rules Auto-Write)

• DEVGENIUS_IDE_TYPE - IDE type: cursor, windsurf, vscode, trae (auto-detect if not set)
• DEVGENIUS_PROJECT_PATH - Project root path (auto-detect if not set)
• DEVGENIUS_AUTO_WRITE_RULES - Auto-write rules file: true or false (default: true)

📚 Available Tools

Project & Tasks (5 tools)

1. get_project_context - Get project context
2. get_my_tasks - Get my task list
3. claim_task - Claim a task
4. update_task_status - Update task status
5. split_task_into_subtasks - Split task into subtasks

Subtasks (2 tools)

6. get_task_subtasks - Get subtasks
7. update_subtask_status - Update subtask status

Documents (7 tools)

8. get_document_categories - Get available document categories
9. list_documents - List documents
10. get_document_by_title - Get document by title
11. search_documents - Search documents
12. create_document - Create a new document
13. update_document - Update a document
14. delete_document - Delete a document
15. get_document_versions - Get document versions

Total: 16 MCP Tools

✨ Features

🎯 Auto Rules Sync (v1.2.0)

• Auto-detect IDE type (Cursor, Windsurf, VS Code, Trae)
• Auto-detect project root (Git root or current directory)
• Auto-write rules file on MCP initialization
• Backup existing files before overwrite (with timestamp)
• Variable rendering ({{project_name}}, {{member_name}}, etc.)

📝 Rules Files

• Cursor: .cursorrules
• Windsurf: .windsurfrules
• VS Code: .vscode/cursor-rules.md
• Trae: .trae/rules.md

🔍 Troubleshooting

uvx not found

Install uv first:

# Windows (PowerShell)
irm https://astral.sh/uv/install.ps1 | iex

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

Token not set

Make sure DEVGENIUS_MCP_TOKEN is set in the AI IDE configuration.

Rules not auto-written

Check the log file devgenius_mcp_server.log:

• Is the project configured with Rules in DevGenius backend?
• Is DEVGENIUS_AUTO_WRITE_RULES set to true?
• Does the MCP have permission to write to the project directory?

📖 Documentation

• MCP Rules Auto-Write Guide
• Implementation Details

📝 License

MIT