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 集成指南
• 功能特性清單

📄 許可證

暫未提及相關許可證信息。

⚠️ 重要提示

本項目仍在開發中，接口和功能可能會有變動，請以最終版本為準。