Mo 任务管理工具文档

简介

Mo 是一个为 Cursor IDE 设计的 Model Context Protocol (MCP) 服务器。它允许与 Linear 进行集成，提供问题跟踪和任务管理功能。

项目状态

• 版本: v1.0.0
• 开发状态: 开发中
• 开始日期: 2023年10月1日
• 计划完成日期: 2024年6月30日

阶段里程碑:

功能特性

• 核心功能:

  • MCP 服务器实现
  • 命令处理模块
  • 数据持久化存储
  • Linear API 集成
  • 辅助工具函数
  • 类型定义

• 命令支持:

  • 任务管理命令
  • Linear 团队和项目查询
  • 问题跟踪功能

• 集成能力:

  • Cursor IDE 支持
  • Claude 聊天模式集成
  • 命令行工具接口

安装说明

全包安装

npm install mo-mcp

手动安装

1. 下载源码压缩包: mo-linear-mcp-v1.0.0.zip
2. 解压文件到指定目录
3. 运行启动脚本:

   node dist/index.js
   

配置指南

MCP 服务器配置

编辑 config.json 文件，添加以下内容：

{
  "mcp_port": 3000,
  "linear_api_key": "your_linear_api_key",
  "data_storage_path": "data"
}

示例配置文件

// config.json 示例
{
  "mcp_port": 3000,
  "linear_api_key": "123456789abcdefg",
  "data_storage_path": "./data"
}

使用命令

帐户认证

/mo linear-auth key:your_linear_api_key

示例用法

在终端中运行：

# 获取 Linear 团队列表
/mo linear-teams

# 查询指定团队的项目
/mo linear-projects team:team-id

# 同步数据到 Linear
/mo linear-sync

开发指南

项目架构

mo-linear-mcp/
├── src/             # 源代码目录
│   ├── index.ts     # 入口文件
│   ├── server.ts    # MCP 服务器实现
│   ├── commands/    # 命令处理模块
│   ├── data/        # 数据持久化存储
│   ├── linear/      # Linear API 集成
│   ├── utils/       # 辅助工具函数
│   └── types/       # 类型定义文件
├── data/            # 本地数据存储目录
└── docs/            # 文档资料
    ├── architecture/  # 架构文档
    ├── mcp/           # MCP 相关文档
    ├── linear/        # Linear 集成文档
    └── features/      # 功能说明文档

开发命令

# 构建项目
npm run build

# 启动调试模式
npm run dev

# 监控文件变化
npm run watch

# 运行代码检查工具
npm run lint

# 执行测试用例
npm test

发布指南

# 准备发布版本
npm version major/minor/patch

# 提交变更
git add package.json package-lock.json
git commit -m "version upgrade"

# 推送到远程仓库
git push origin main

调试技巧

调试日志输出

DEBUG=mo-linear-mcp npm run dev

常见问题排查

1. 检查配置文件是否正确加载。
2. 确保 Linear API 密钥有效。
3. 查看控制台错误信息。

文档资源

• 架构设计文档
• MCP 详细说明
• Linear 集成指南
• 功能特性清单

注意: 本项目仍在开发中，接口和功能可能会有变动，请以最终版本为准。