Mo - Linear Task Management for Cursor IDE

Mo - Cursor IDE 的 Linear 任务管理

Mo 是一款任务管理工具，作为适用于 Cursor IDE 的 Model Context Protocol（MCP）服务而设计。它与 Linear 无缝集成，用于问题跟踪和任务管理，让开发者能够直接在 Cursor 中管理工作流。

项目状态

• 阶段 1：✅ 已完成（2024 年 3 月 21 日）- 核心基础设施和基本任务管理
• 阶段 2：✅ 已完成（2024 年 4 月 5 日）- Linear 集成和聊天工具支持
• 阶段 3：🔄 进行中 - AI 增强功能
• 阶段 4：📅 计划中 - 高级功能和完善

有关项目时间线和各阶段的详细信息，请参阅项目计划。

功能

• 任务管理：直接在 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" 路径，使其与本地代码库路径相符（用于开发模式）

开发和发布

本地开发

用于快速开发和测试：

# Watch for changes
npm run watch

# In another terminal, test commands
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 拉取问题

聊天模式工具

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

@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/             # Source code
│   ├── index.ts     # Entry point
│   ├── server.ts    # MCP server implementation
│   ├── commands/    # Command processing
│   ├── data/        # Data persistence
│   ├── linear/      # Linear API integration
│   ├── utils/       # Utility functions
│   └── types/       # TypeScript types
├── data/            # Local data storage
└── docs/            # Documentation
    ├── architecture/  # Architecture documentation
    ├── mcp/           # MCP-related documentation
    ├── linear/        # Linear integration documentation
    └── features/      # Feature specifications

开发命令

# Build the project
npm run build

# Run in development mode
npm run dev

# Watch for changes
npm run watch

# Run linter
npm run lint

# Run tests
npm run test

发布

要将软件包发布到 npm：

# Build the project
npm run build

# Make sure the binary is executable
chmod +x dist/index.js

# Create npm account if needed
npm adduser

# Publish to npm
npm publish

调试

Mo 内置了调试功能，日志会写入 /tmp/mo-mcp-debug.log。排查问题时请检查此文件。

如需更详细的调试：

# Test MCP response handling
echo '{"command": "/mo linear-status"}' | npm run dev

# Test chat tool invocation directly
node dist/index.js linear_status

文档

• 项目计划 - 项目总体计划和时间表
• 项目背景 - 项目状态和背景
• MCP 聊天集成 - 聊天集成详情
• 命令 - 命令文档
• Linear MCP 集成 - Linear 集成详情
• 实现指南 - 开发指南

许可证

本项目采用 ISC 许可证授权，详情请参阅 LICENSE 文件。

致谢

• Cursor IDE 提供 MCP 平台
• Linear 提供出色的问题跟踪 API