Mo - Linear Task Management for Cursor IDE

Mo - Cursor IDE 向け Linear タスク管理

Mo は、Cursor IDE 向けの Model Context Protocol（MCP）サーバーとして設計されたタスク管理ツールです。Linear とシームレスに連携して課題追跡とタスク管理を行い、開発者は Cursor 内から直接ワークフローを管理できます。

プロジェクトの状況

• フェーズ 1：✅ 完了（2024 年 3 月 21 日）- コアインフラストラクチャと基本的なタスク管理
• フェーズ 2：✅ 完了（2024 年 4 月 5 日）- Linear 連携とチャットツールのサポート
• フェーズ 3：🔄 進行中 - AI 機能の強化
• フェーズ 4：📅 計画中 - 高度な機能と仕上げ

プロジェクトのスケジュールとフェーズの詳細については、プロジェクト計画を参照してください。

機能

• タスク管理：Cursor 内でタスクを直接作成、更新、追跡できます
• コンテキスト認識：コードの選択範囲や現在のファイルのコンテキストからタスクを作成できます
• プロトコルバージョンの処理：Cursor MCP プロトコルのバージョン互換性をサポートします
• リッチな応答：アクションボタン付きの Markdown 形式の応答を提供します
• Linear 連携：チームでの共同作業のため、タスクを Linear と同期します
  • 認証情報を安全に保存して認証
  • ローカルタスクと Linear の課題を双方向に同期
  • Linear の課題のフィルタリングとクエリ
  • プロジェクト、チーム、ワークフローの状態をサポート
• チャット連携：Cursor 内の Claude チャットで Linear ツールを直接使用できます
• Webhook のサポート：課題の更新をリアルタイムで受け取るための Webhook を登録できます（任意）

インストール

前提条件

• Cursor IDE
• Node.js 16+
• Linear アカウント（Linear 連携用）

オプション 1：npm からインストール（推奨）

パッケージは npm で公開されており、グローバルにインストールできます：

npm install -g mo-linear-mcp

インストールせずに npx で直接実行することもできます：

npx mo-linear-mcp

npm のパッケージページ：mo-linear-mcp

オプション 2：ローカル開発環境のセットアップ

1. このリポジトリをクローンします：

   git clone https://github.com/yourusername/mo-linear-mcp.git
   cd mo-linear-mcp
   

2. 依存関係をインストールします：

   npm install
   

3. プロジェクトをビルドします：

   npm run build
   

4. 開発モードで実行します：

   npm run dev
   

Cursor 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 設定を開くには：

1. Cursor IDE を開きます
2. ［Settings］→［Extensions］→［MCP Servers］に移動します
3. ［Edit MCP Config］をクリックし、上記の設定を貼り付けます
4. 開発モードの場合は、ローカルリポジトリのパスに合わせて「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 - 設定を表示・更新します

Linear コマンド

• /mo linear-auth - Linear API で認証します
• /mo linear-status - Linear の認証状態を確認します
• /mo linear-logout - Linear API からログアウトします
• /mo linear-teams - Linear のチームを一覧表示します
• /mo linear-projects - Linear のプロジェクトを一覧表示します
• /mo linear-states - Linear のワークフロー状態を一覧表示します
• /mo linear-issues - Linear の課題を一覧表示します
• /mo linear-sync - Linear と同期します
• /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 との連携を使用するには、Linear API キーで認証する必要があります。

/mo linear-auth key:your_linear_api_key

または、チャットモードでは次のようにします。

@Linear linear_auth key:your_linear_api_key

Linear API キーは、Linear の設定ページで取得できます。

開発

プロジェクト構成

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

ドキュメント

• プロジェクト計画 - 全体的な計画とスケジュール
• プロジェクトのコンテキスト - プロジェクトの状況とコンテキスト
• MCP チャット連携 - チャット連携の詳細
• コマンド - コマンドのドキュメント
• Linear MCP 連携 - Linear 連携の詳細
• 実装ガイド - 開発ガイド

ライセンス

このプロジェクトは ISC ライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

謝辞

• MCP プラットフォームを提供する Cursor IDE
• 優れた課題追跡 API を提供する Linear