リニアMCPサーバー

AI アシスタントが Linear プロジェクト管理システムと対話できるようにする Linear GraphQL API 用のモデル コンテキスト プロトコル (MCP) サーバー実装。

特徴

• MCPツールを介したLinearのGraphQL APIへのアクセス

• リニアAPIキーによる認証

• ユーザー、チーム、プロジェクト、問題に関連するデータを取得および変更する

• 問題の作成、更新、コメント

• ラベルの追加と削除

• プロジェクトを作成する

• 利用可能なツールの包括的なドキュメント

Related MCP server: MCP Linear App

インストール

Smithery 経由でインストールする (推奨)

Smithery 経由で Claude Desktop 用の Linear MCP Server を自動的にインストールするには:

npx -y @smithery/cli install @emmett.deen/linear-mcp-server --client claude

手動設定

インストール後、MCP 設定ファイルに以下を追加します。

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@emmett.deen/linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

クライアント固有の設定場所

• Claude デスクトップ: ~/Library/Application Support/Claude/claude_desktop_config.json

• Claude VSCode 拡張機能: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

• GoMCP: ~/.config/gomcp/config.yaml

手動インストール

1. リポジトリをクローンする

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. 依存関係をインストールする

npm install

3. プロジェクトを構築する

npm run build

4. Linear APIトークンを使用して.envファイルを作成する

LINEAR_API_KEY=your_linear_api_key_here

5. サーバーを起動する

npm start

利用可能なツール

利用可能なツールと計画されている機能の完全なリストについては、 TOOLS.md を参照してください。

概要

Linear-MCP-Serverは、MCPプロトコルを実装することで、Claude（AIアシスタント）とLinear（プロジェクト管理ツール）間のギャップを埋めます。これにより、Claudeは以下のことが可能になります。

• 問題、プロジェクト、チーム、その他のデータをLinearから取得する

• 問題の作成と更新

• 問題のステータスを変更する

• チームメンバーに問題を割り当てる

• コメントを追加する

• プロジェクトとチームを作成する

サーバーは、簡潔にするために Linear の GraphQL API を使用し、ユーザー トークン (OAuth ではない) を介して認証します。

はじめる

前提条件

• Node.js (v18+)

• NPMまたはYarn

• リニアAPIトークン

インストール

# Install globally
npm install -g @emmett.deen/linear-mcp-server

# Or clone and install locally
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server
npm install
npm link  # Makes the package available globally

サーバーの実行

Linear API トークンを使用してサーバーを実行します。

linear-mcp-server --token YOUR_LINEAR_API_TOKEN

または、環境にトークンを設定し、引数なしで実行します。

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
linear-mcp-server

Claude Desktopでの使用

この MCP サーバーを Claude Desktop で使用するには:

1. Claude Desktopで開発者モードを有効にする（メニューバーから）

2. 「設定」>「開発者向けオプション」に移動します

3. 「サーバーを追加」をクリックします

4. 次の設定で構成します。

   • 名前: リニアMCPサーバー

   • タイプ: ローカルプロセス

   • コマンド: linear-mcp-server

   • 引数: --token YOUR_LINEAR_API_TOKEN

または、構成ファイルを手動で編集します。

{
  "mcp": {
    "servers": [
      {
        "name": "Linear MCP Server",
        "transport": {
          "type": "stdio",
          "command": "linear-mcp-server",
          "args": ["--token", "YOUR_LINEAR_API_TOKEN"]
        }
      }
    ]
  }
}

5. 設定を保存する

6. Claude Desktopを再起動します（完全に終了して再度開きます）

7. これで、Claudeでツールとして利用できるLinear MCP Serverが表示されるはずです。

クロードのプロンプトの例

Claude Desktop に接続すると、次のようなプロンプトを使用できるようになります。

• 「すべてのLinearの問題を表示」

• 「フロントエンドチームに「ログインバグの修正」というタイトルの新しい問題を作成します」

• 「問題 FE-123 のステータスを「進行中」に変更する」

• 「問題 BE-456 を John Smith に割り当てる」

• 「問題 UI-789 にコメントを追加: 'これは金曜日までに修正する必要があります'」

発達

ローカルで開発するには:

# Clone the repository
git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

# Install dependencies
npm install

# Run in development mode
npm run dev -- --token YOUR_LINEAR_API_TOKEN

サーバーの拡張

サーバーに新しいツールを追加するには:

1. TOOLS.mdドキュメントの実装ガイドに従ってください。

2. src/ディレクトリ内の確立されたコード構造に従ってください。

3. 変更を反映するようにドキュメントを更新します

開発と貢献

開発環境のセットアップ

1. リポジトリをクローンする

git clone https://github.com/yourusername/Linear-MCP-Server.git
cd Linear-MCP-Server

2. 依存関係をインストールする

npm install

3. 開発モードで開始

npm run dev

npmへの公開

このパッケージを npm に公開するには:

1. package.jsonのバージョンを更新する

npm version patch  # or minor, or major

2. プロジェクトを構築する

npm run build

3. npmにログインしていることを確認してください

npm login

4. npmに公開する

npm publish --access public

5. Smithery レジストリの場合、サーバーをカタログに掲載するには Smithery チームと協力する必要があります。

ライセンス

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