Gorev:AI驱动的任务管理系统使用说明

项目简介

Gorev是一个先进的、支持中文的AI驱动任务管理系统,基于Model Context Protocol (MCP) 标准构建。它以Go语言编写,提供一个强大的后端服务器,允许各类AI助手(如Claude Desktop, VS Code, Windsurf, Cursor等)通过自然语言进行任务创建、管理和查询。Gorev通过丰富的工具集、层级任务管理、依赖关系、标签系统和智能模板,提升AI助手在项目管理中的应用效率。

主要功能点

  • 智能任务管理: 支持自然语言创建任务、Markdown描述、任务状态/优先级管理、截止日期追踪、标签分类及无限层级子任务。
  • 项目组织: 提供项目创建、任务分组、活跃项目设置、多项目支持及项目报告功能。
  • AI上下文整合: 包含AI活动追踪、最近任务获取、会话摘要、批量任务更新、自然语言查询(NLP)等AI助手专用工具。
  • 文件系统监控: 能够监控与任务关联的文件,并在文件发生更改时自动更新任务状态。
  • 高级搜索与过滤: 支持FTS5全文搜索、模糊匹配,并可保存、加载和管理筛选器配置。
  • 数据导入导出: 支持将任务、项目等数据导出为JSON或CSV格式,并支持从文件导入数据。
  • IDE扩展管理: 提供IDE检测、Gorev扩展安装/卸载/更新/状态查询等功能,方便在兼容IDE中集成。
  • 丰富的工具集: 提供40+个MCP工具,覆盖任务、项目、模板、AI上下文、文件监控和搜索等多个领域。

安装步骤

Gorev可以作为MCP服务器运行,并被各种MCP客户端(如Claude Desktop, VS Code, Windsurf, Cursor)集成。 最简单的安装方式是使用 'npx'。它会自动下载并运行适用于您系统的Gorev二进制文件。

  1. 确保您已安装Node.js和npm/npx。 您可以在命令行运行 'node -v' 和 'npx -v' 来检查。

  2. 配置MCP客户端: 在您的MCP客户端的配置文件中(例如,Claude Desktop的 '~/.config/Claude/claude_desktop_config.json' 或VS Code的 '.vscode/mcp.json'),添加以下服务器配置:

    {
      "mcpServers": {
        "gorev": {
          "command": "npx",
          "args": ["@mehmetsenol/gorev-mcp-server@latest"],
          "env": {
            "GOREV_LANG": "zh" // 可选:配置服务器语言为中文,默认为土耳其语
          }
        }
      }
    }
    • 'mcpServers.gorev': 定义一个名为 "gorev" 的MCP服务器。
    • 'command': 指定启动Gorev服务器的命令,这里使用 'npx'。
    • 'args': 传递给 'npx' 的参数,指示运行最新的 '@mehmetsenol/gorev-mcp-server' 包,并自动启动服务器模式。
    • 'env': 环境变量,'GOREV_LANG' 用于设置服务器的显示语言('zh' 表示中文)。
    • 注意: 不同的MCP客户端可能略有不同的配置结构,请根据您的客户端文档进行调整。
  3. 可选:手动安装二进制文件 如果您不想使用 'npx',可以从Gorev的GitHub Releases页面('https://github.com/msenol/Gorev/releases')手动下载适用于您操作系统的二进制文件,并将其路径配置到MCP客户端的 'command' 字段中。

基本使用方法

配置完成后,您可以通过兼容的AI助手(如Claude, VS Code Copilot, Cursor等)直接与Gorev服务器进行自然语言交互。AI助手将调用Gorev提供的MCP工具来执行您的请求。以下是一些示例命令:

  • 创建任务: "创建一个新任务:编写API文档,明天截止,优先级高" "使用‘Bug Rapor’模板创建一个新任务,标题为‘登录按钮无法点击’,描述为‘用户点击登录按钮后无响应’,模块为‘认证’,环境为‘生产’,优先级为‘高’"
  • 列出任务: "显示我这周所有高优先级的任务" "列出所有状态为‘进行中’的任务"
  • 查看任务详情: "显示任务 #5 的详细信息"
  • 更新任务: "将任务 #5 标记为已完成" "更新任务 #10,将标题改为‘更新用户界面’,并将优先级设置为‘中’"
  • 列出项目: "列出所有项目"
  • 激活项目: "将‘移动App v2’项目设置为活跃项目"
  • 列出模板: "显示所有任务模板"
  • 文件监控: "开始监控‘src/main.go’文件,并关联到任务 #10" "列出任务 #10 正在监控的所有文件"
  • AI上下文摘要: "给我一个AI会话的上下文摘要" "我的活跃任务是什么?"

信息

分类

AI与计算