リニアMCPサーバー

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

特徴

MCPツールを介したLinearのGraphQL APIへのアクセス
リニアAPIキーによる認証
ユーザー、チーム、プロジェクト、問題に関連するデータを取得および変更する
問題の作成、更新、コメント
ラベルの追加と削除
プロジェクトを作成する
利用可能なツールの包括的なドキュメント

インストール

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

手動インストール

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

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

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

npm install

プロジェクトを構築する

npm run build

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

LINEAR_API_KEY=your_linear_api_key_here

サーバーを起動する

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 で使用するには:

Claude Desktopで開発者モードを有効にする（メニューバーから）
「設定」>「開発者向けオプション」に移動します
「サーバーを追加」をクリックします
次の設定で構成します。
- 名前: リニア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"]
        }
      }
    ]
  }
}

設定を保存する
Claude Desktopを再起動します（完全に終了して再度開きます）
これで、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

サーバーの拡張

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

TOOLS.mdドキュメントの実装ガイドに従ってください。
src/ディレクトリ内の確立されたコード構造に従ってください。
変更を反映するようにドキュメントを更新します

開発と貢献

開発環境のセットアップ

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

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

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

npm install

開発モードで開始

npm run dev

npmへの公開

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

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

npm version patch  # or minor, or major

プロジェクトを構築する

npm run build

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

npm login

npmに公開する

npm publish --access public

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

ライセンス

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