Mo

🚀 Mo 任务管理工具文档

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

🚀 快速开始

Mo 作为一款实用的任务管理工具，能为 Cursor IDE 用户带来便捷的任务管理体验。通过简单的安装和配置，即可开启高效的任务管理之旅。

✨ 主要特性

核心功能

• 实现 MCP 服务器，为系统运行提供基础支撑。
• 具备命令处理模块，方便用户通过命令操作。
• 支持数据持久化存储，确保数据安全不丢失。
• 集成 Linear API，可与 Linear 进行数据交互。
• 拥有辅助工具函数，提升开发和使用效率。
• 提供类型定义，使代码结构更加清晰。

命令支持

• 支持任务管理命令，轻松管理各类任务。
• 可进行 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 集成指南
• 功能特性清单

📄 许可证

暂未提及相关许可证信息。

⚠️ 重要提示

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