Mo - Cursor IDE 的线性任务管理

Mo 是一个为 Cursor IDE 设计的任务管理工具，它作为一个模型上下文协议 (MCP) 服务器。它提供了与 Linear 的无缝集成，用于问题跟踪和任务管理，允许开发者直接在 Cursor 中管理他们的工作流程。

项目状态

• 第一阶段: ✅ 已完成 (2024年3月21日) - 核心基础设施和基本任务管理
• 第二阶段: ✅ 已完成 (2024年4月5日) - Linear 集成和聊天工具支持
• 第三阶段: 🔄 进行中 - AI 增强功能
• 第四阶段: 📅 计划中 - 高级功能和优化

请参阅 项目计划 以获取有关项目时间表和阶段的更多详细信息。

功能

• 任务管理: 直接在 Cursor 中创建、更新和跟踪任务
• 上下文感知: 从代码选择或当前文件上下文中创建任务
• 协议版本处理: 支持 Cursor MCP 协议版本兼容性
• 富响应: 带有操作按钮的 Markdown 格式响应
• Linear 集成: 将任务与 Linear 同步以进行团队协作
  • 使用安全凭证存储进行身份验证
  • 本地任务和 Linear 问题之间的双向同步
  • 过滤和查询 Linear 问题
  • 支持项目、团队和工作流程状态
• 聊天集成: 直接在 Cursor 中的 Claude 聊天中使用 Linear 工具
• Webhook 支持: 注册 Webhook 以获取实时问题更新（可选）

安装

前提条件

• Cursor IDE
• Node.js 16+
• Linear 帐户（用于 Linear 集成）

选项 1：从 npm 安装（推荐）

该软件包可在 npm 上获得，可以全局安装：

npm install -g mo-linear-mcp

您也可以通过 npx 直接使用它，无需安装：

npx mo-linear-mcp

访问 npm 上的软件包：mo-linear-mcp

选项 2：本地开发设置

1. 克隆此存储库：

   git clone https://github.com/yourusername/mo-linear-mcp.git
   cd mo-linear-mcp
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 在开发模式下运行：

   npm run dev
   

Cursor MCP 配置

要在 Cursor 中使用 Mo，您需要在 MCP 设置中对其进行配置。这是一个示例配置：

{
  "version": "0.1",
  "mcps": {
    "mo-linear-mcp-dev": {
      "name": "Mo Linear MCP (Dev)",
      "description": "Linear Task Management for Cursor IDE - Development Mode",
      "command": "npm",
      "args": ["run", "dev"],
      "cwd": "/path/to/your/mo-linear-mcp",
      "enabled": true
    },
    "linear": {
      "name": "Linear",
      "description": "Linear Task Management for Cursor",
      "command": "npx",
      "args": ["-y", "mo-linear-mcp"],
      "enabled": true
    }
  }
}

要在 Cursor 中访问 MCP 配置：

1. 打开 Cursor IDE
2. 转到 Settings → Extensions → MCP Servers
3. 单击 "Edit MCP Config" 并粘贴上面的配置
4. 调整 "cwd" 路径以匹配您的本地存储库路径（用于开发模式）

开发和发布

本地开发

为了快速开发和测试：

# 监听更改
npm run watch

# 在另一个终端中，测试命令
echo '{"command": "/mo linear-status"}' | npm run dev

用法

编辑器模式命令

Mo 提供了可以直接在编辑器中使用的命令：

基本命令

• /mo tasks - 列出所有任务，带有可选的过滤
• /mo new-task - 创建一个新任务
• /mo update-task - 更新现有任务
• /mo task-details - 查看任务详细信息
• /mo delete-task - 删除任务
• /mo help - 显示帮助信息
• /mo settings - 查看/更新设置

Linear 命令

• /mo linear-auth - 使用 Linear API 进行身份验证
• /mo linear-status - 检查 Linear 身份验证状态
• /mo linear-logout - 从 Linear API 注销
• /mo linear-teams - 列出 Linear 团队
• /mo linear-projects - 列出 Linear 项目
• /mo linear-states - 列出 Linear 工作流程状态
• /mo linear-issues - 列出 Linear 问题
• /mo linear-sync - 与 Linear 同步
• /mo linear-push - 将任务推送到 Linear
• /mo linear-pull - 从 Linear 拉取问题

聊天模式工具

Mo 也可以直接在 Claude 聊天界面中使用，语法如下：

@Linear linear_auth key:your_api_key
@Linear linear_status
@Linear linear_teams
@Linear linear_projects team:team-id
@Linear linear_issues team:team-id
@Linear linear_sync

身份验证

要使用 Linear 集成，您需要使用您的 Linear API 密钥进行身份验证：

/mo linear-auth key:your_linear_api_key

或者在聊天模式下：

@Linear linear_auth key:your_linear_api_key

您可以从 Linear 的设置页面获取您的 Linear API 密钥。

开发

项目结构

mo-linear-mcp/
├── src/             # 源代码
│   ├── index.ts     # 入口点
│   ├── server.ts    # MCP 服务器实现
│   ├── commands/    # 命令处理
│   ├── data/        # 数据持久化
│   ├── linear/      # Linear API 集成
│   ├── utils/       # 实用函数
│   └── types/       # TypeScript 类型
├── data/            # 本地数据存储
└── docs/            # 文档
    ├── architecture/  # 架构文档
    ├── mcp/           # MCP 相关文档
    ├── linear/        # Linear 集成文档
    └── features/      # 功能规范

开发命令

# 构建项目
npm run build

# 在开发模式下运行
npm run dev

# 监听更改
npm run watch

# 运行 linter
npm run lint

# 运行测试
npm run test

发布

要将软件包发布到 npm：

# 构建项目
npm run build

# 确保二进制文件是可执行的
chmod +x dist/index.js

# 如果需要，创建 npm 帐户
npm adduser

# 发布到 npm
npm publish

调试

Mo 包括内置调试，它会记录到 /tmp/mo-mcp-debug.log。检查此文件以进行故障排除。

对于更详细的调试：

# 测试 MCP 响应处理
echo '{"command": "/mo linear-status"}' | npm run dev

# 直接测试聊天工具调用
node dist/index.js linear_status

文档

• 项目计划 - 高级计划和时间表
• 项目上下文 - 项目状态和上下文
• MCP 聊天集成 - 聊天集成详细信息
• 命令 - 命令文档
• Linear MCP 集成 - Linear 集成详细信息
• 实施指南 - 开发指南

许可证

该项目根据 ISC 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• Cursor IDE 用于 MCP 平台
• Linear 用于他们出色的问题跟踪 API