🚀 Mo 任务管理工具文档
Mo 是专为 Cursor IDE 设计的 Model Context Protocol (MCP) 服务器，它能与 Linear 集成，提供强大的问题跟踪和任务管理功能。
🚀 快速开始
Mo 作为一款实用的任务管理工具，能为 Cursor IDE 用户带来便捷的任务管理体验。通过简单的安装和配置，即可开启高效的任务管理之旅。
✨ 主要特性
核心功能
- 实现 MCP 服务器，为系统运行提供基础支撑。
- 具备命令处理模块，方便用户通过命令操作。
- 支持数据持久化存储，确保数据安全不丢失。
- 集成 Linear API，可与 Linear 进行数据交互。
- 拥有辅助工具函数，提升开发和使用效率。
- 提供类型定义，使代码结构更加清晰。
命令支持
- 支持任务管理命令，轻松管理各类任务。
- 可进行 Linear 团队和项目查询，快速获取相关信息。
- 具备问题跟踪功能，及时发现和解决问题。
集成能力
- 支持 Cursor IDE，无缝融入开发环境。
- 集成 Claude 聊天模式，提供更智能的交互体验。
- 提供命令行工具接口，方便开发者进行定制操作。
📦 安装指南
全包安装
使用以下命令进行全包安装：
npm install mo-mcp
手动安装
- 下载源码压缩包：
mo-linear-mcp-v1.0.0.zip。 - 将文件解压到指定目录。
- 运行启动脚本：
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
常见问题排查
- 检查配置文件是否正确加载。
- 确保 Linear API 密钥有效。
- 查看控制台错误信息。
文档资源
- 架构设计文档
- MCP 详细说明
- Linear 集成指南
- 功能特性清单
📄 许可证
暂未提及相关许可证信息。
⚠️ 重要提示
本项目仍在开发中，接口和功能可能会有变动，请以最终版本为准。