Linear MCP Server

🚀 線形MCPサーバ

このサーバは、モデルコンテキストプロトコル (MCP) を用いて、LinearのAPIとのやり取りを可能にし、AIエージェントがLinearプラットフォーム上での問題、プロジェクト、チームのプログラム管理を実現します。

⚠️ 重要提示

これはカスタム実装です。公式のCline線形MCPサーバについては、cline/linear-mcp を参照してください。

🚀 クイックスタート

1. Linearの開発者設定 からあなたのLinear APIキーを取得します。
2. あなたのAPIキーを使用して以下のコマンドを実行します。

LINEAR_API_KEY=your-api-key npx @ibraha7m/linear-mcp-server

✨ 主な機能

• 問題管理
  • カスタマイズ可能な属性（タイトル、説明、チーム、担当者、優先度、ラベル）を持つ新しい問題を作成します。
  • 柔軟なフィルタオプション（チーム、担当者、状態）で問題を一覧表示します。
  • 既存の問題（タイトル、説明、状態、担当者、優先度）を更新します。
• チーム管理
  • ワークスペース内のすべてのチームを一覧表示します。
  • ID、名前、キー、説明を含むチームの詳細情報にアクセスします。
• プロジェクト管理
  • 任意のチームフィルタですべてのプロジェクトを一覧表示します。
  • 名前、説明、状態、関連するチームを含むプロジェクトの詳細情報を表示します。

📦 インストール

npmを使用してグローバルにインストールします。

npm install -g @ibraha7m/linear-mcp-server

📚 ドキュメント

前提条件

• Node.js (v16以上)
• APIアクセス権を持つLinearアカウント
• 適切な権限を持つLinear APIキー

設定

環境変数

以下の環境変数を設定します。

• LINEAR_ACCESS_TOKEN：あなたのLinear APIアクセストークン
• PORT（オプション）：サーバが実行されるポート。デフォルトは3000です。

使用方法

# 開発モード（自動再構築）
npm run dev

# 本番モード
npm start

💻 使用例

基本的な使用法

問題の作成

{
  "command": "createIssue",
  "arguments": {
    "title": "問題标题",
    "description": "問題描述",
    "projectId": "项目 ID",
    "priority": 1,
    "assigneeId": "分配人 ID"
  }
}

問題の更新

{
  "command": "updateIssue",
  "arguments": {
    "issueId": "問題 ID",
    "title": "新标题",
    "description": "新描述",
    "status": "新状态",
    "assigneeId": "新分配人 ID",
    "priority": 2
  }
}

🔧 技術詳細

• TypeScriptとLinear SDK (@linear/sdk v37.0.0) を使用しています。
• MCP SDK (@modelcontextprotocol/sdk v0.6.0) を使用しています。

サーバは標準入出力を使用して通信し、モデルコンテキストプロトコルを実装してAIエージェントとのシームレスな統合を実現しています。

📄 ライセンス

MIT