Mcptix工单系统简介

Mcptix 是一个易于使用且功能强大的工单跟踪系统,旨在帮助用户高效管理项目中的任务、缺陷和功能需求。它通过看板视图直观展示工单状态,支持创建、更新、评论和删除工单,并集成了AI助手功能。Mcptix 的 MCP 服务器允许AI助手连接并操作工单数据,实现更智能化的工作流程。

主要功能点:

  • 工单管理: 创建、更新、查看和删除工单,支持多种状态和优先级。
  • 看板视图: 以看板形式直观展示工单在不同状态下的流转。
  • 评论协作: 支持在工单下添加评论,方便团队成员协作沟通。
  • AI助手集成: 内置 MCP 服务器,支持AI助手通过标准协议访问和操作工单数据。
  • 复杂度评估: 通过复杂度智能引擎 (CIE) 评估工单的开发复杂度 (UI界面操作,非MCP功能)。

安装步骤:

  1. 安装 Mcptix 包: 打开终端,导航到你的项目目录,运行以下命令安装 Mcptix 包:

    npm install @ownlytics/mcptix
  2. 初始化 Mcptix: 在项目目录下运行初始化命令,这将创建 '.mcptix' 目录并生成配置文件:

    npx mcptix init
  3. 启动 Mcptix UI: 运行以下命令启动 Mcptix UI 界面 (API服务器):

    npx mcptix start

    Mcptix UI 将在浏览器中自动打开,你可以在UI界面中管理工单。

MCP 服务器配置:

Mcptix 的 MCP 服务器设计为由 MCP 客户端(如 AI 助手)启动,而非手动启动。你需要配置你的 MCP 客户端,使其能够启动和连接 Mcptix 的 MCP 服务器。

在初始化 Mcptix 后,'.mcptix' 目录下会生成 'mcp-server-config.json' 文件,该文件包含了 MCP 客户端连接 Mcptix MCP 服务器所需的配置信息。你需要将此配置文件复制到你的 MCP 客户端的配置目录中。

以下是 'mcp-server-config.json' 文件的内容示例 (无需修改,复制到MCP客户端配置目录即可):

{
  "mcpServers": {
    "mcptix": {
      "command": "node",
      "args": ["/absolute/path/to/node_modules/mcptix/dist/mcp/index.js"],
      "env": {
        "MCPTIX_DB_PATH": "/absolute/path/to/.mcptix/data/mcptix.db",
        "HOME": "/home/your-username"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

配置参数说明 (无需修改,仅供参考):

  • 'command': 启动 MCP 服务器的命令,这里使用 'node'。
  • 'args': 启动命令的参数,指向 Mcptix MCP 服务器的入口文件 'index.js' 的绝对路径。
  • 'env': 环境变量配置,'MCPTIX_DB_PATH' 指定了 Mcptix 数据库文件的绝对路径,'HOME' 指定了用户 Home 目录。

请注意: 你需要根据你的实际项目路径,手动更新 'mcp-server-config.json' 文件中的 'args' 和 'env.MCPTIX_DB_PATH' 的绝对路径,确保路径的正确性。

对于不同的 MCP 客户端,配置文件的存放位置和格式可能有所不同,请参考你的 MCP 客户端的文档进行配置。 例如,对于 Roo 客户端,通常需要将 'mcp-server-config.json' 文件复制到项目根目录下的 '.roo/mcp.json' 文件。

基本使用方法:

  • 通过 Mcptix UI 管理工单: 启动 Mcptix UI 后,在浏览器中访问 'http://localhost:3000' (默认地址),即可使用看板视图管理工单。
  • 通过 AI 助手操作工单: 配置 MCP 客户端连接 Mcptix MCP 服务器后,即可在 AI 助手中使用 Mcptix 提供的工具和资源来查询、创建、更新和删除工单,以及添加评论等操作。具体操作方式请参考你的 MCP 客户端的使用说明。

信息

分类

生产力应用