使用说明
游标IDE的非线性任务管理
Mo是一个任务管理工具，被设计为Cursor IDE的模型上下文协议（MCP）服务器。它与Linear无缝集成，用于问题跟踪和任务管理，允许开发人员直接从Cursor中管理他们的工作流程。
项目状态
- 第一阶段: ✅ 完成（2024年3月21日）-核心基础设施和基本任务管理
- 第2阶段: ✅ 完成（2024年4月5日）-线性积分和聊天工具支持
- 第三期: 🔄 进行中-AI增强功能
- 阶段4: 📅 计划中-高级功能和抛光
请参阅 项目计划 有关项目时间表和阶段的更多详细信息。
特性
- 任务管理：直接在Cursor中创建、更新和跟踪任务
- 情境感知：从代码选择或当前文件上下文创建任务
- 协议版本处理：支持Cursor MCP协议版本兼容性
- 丰富的响应：带操作按钮的Markdown格式响应
- 线性积分：与Linear同步任务以实现团队协作
- 使用安全凭据存储进行身份验证
- 本地任务和线性问题之间的双向同步
- 过滤和查询线性问题
- 支持项目、团队和工作流状态
- 聊天集成：在Cursor中的Claude聊天中直接使用线性工具
- Webhook 支持：注册webhooks以获取实时问题更新（可选）
安装
先决条件
- 光标IDE
- Node.js 16+
- 线性账户（用于线性积分）
选项1：从npm安装（推荐）
该包可以在npm上使用，并且可以全局安装：
npm install -g mo-linear-mcp
您也可以直接使用它，而无需通过npx安装：
npx mo-linear-mcp
访问npm上的包： mo线性mcp
选项2：地方发展设置
-
克隆此存储库：
git clone https://github.com/yourusername/mo-linear-mcp.git cd mo-linear-mcp -
安装依赖项：
npm install -
构建项目：
npm run build -
在开发模式下运行：
npm run dev
光标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配置：
- 打开光标IDE
- 转到“设置”→ 扩展→ MCP服务器
- 点击“编辑MCP配置”并粘贴上面的配置
- 调整“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-查看/更新设置
线性命令
/mo linear-auth-使用线性API进行身份验证/mo linear-status-检查线性身份验证状态/mo linear-logout-从线性API注销/mo linear-teams-列出线性团队/mo linear-projects-列出线性项目/mo linear-states-列出线性工作流状态/mo linear-issues-列出线性问题/mo linear-sync-与线性同步/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 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
文档
许可证
此项目根据ISC许可证获得许可-有关详细信息，请参阅许可证文件。
