MCP Server Linear

🚀 mcp-server-linear

このサーバーは、Linear APIとのやり取りを行うモデルコンテキストプロトコル（MCP）サーバーです。標準化されたMCPインターフェースを通じて、Linearの問題、プロジェクト、その他のデータにアクセスし操作するためのツールとリソースを提供します。

🚀 クイックスタート

mcp-server-linear プロジェクトは、クライアントアプリケーション（特にAIアシスタントやその他のツール）とLinearの間の橋渡し役を果たし、Linearリソースへの標準化されたインターフェースを通じたアクセスを提供します。

✨ 主な機能

• Linearリソース（問題、プロジェクト、イニシアチブ、チーム）への標準的なアクセス
• 問題とコメントの完全なCRUD操作
• 問題の高度なフィルタリングと検索機能
• 一貫したエラー処理とレスポンス形式
• MCPプロトコルを通じたAIアシスタントとの統合

📦 インストール

依存関係のインストール

pnpmを使ってプロジェクトの依存関係をインストールします。

pnpm install

サーバーの起動

MCPサーバーを起動します。

pnpm run start

設定オプション

環境変数

• LINEAR_API_KEY：認証に必要な環境変数です。
• PORT：オプションで、デフォルトは3000です。サーバーが動作するポートを指定します。

💻 使用例

基本的な使用法

# サーバーを起動する（デバッグモードを含む）
pnpm run start -- --debug

# ログファイルのパスを定義する
pnpm run start -- --log-file custom.log

高度な使用法

# テストを実行する
pnpm test

# プロジェクトをビルドする
pnpm run build

# 変更を監視する
pnpm run watch

# デバッグモードで実行する
pnpm run debug

MCPインスペクターツール

MCPインスペクターツールを使ってサーバーとやり取りするには、以下の手順を実行します。

1. MCPインスペクターツールをグローバルにインストールする。

pnpm install -g @modelcontextprotocol/inspector

2. npxを使ってインスペクターツールを起動する。

LINEAR_API_KEY=your_api_key_here npx -y @modelcontextprotocol/inspector @mkusaka/mcp-server-linear

🔧 技術詳細

このサーバーは、モデルコンテキストプロトコル（MCP）アーキテクチャに従っており、Linearリソースへの標準化されたアクセス方法を提供します。主要なアーキテクチャ上の決定事項は以下の通りです。

1. リソースの組織：リソースをドメインごとに個別のファイルに組織する。
2. エラー処理：すべてのリソースに対して一貫したエラー処理を行う。
3. レスポンス形式：一貫したJSONレスポンス形式を使用する。

詳細については、adr.mdを参照してください。

📚 ドキュメント

Linear API認証

このサーバーは、2種類の認証方法をサポートしています。

1. APIキー認証

環境変数にLINEAR_API_KEYを設定します。例えば：

LINEAR_API_KEY=your_api_key_here pnpm run start

2. OAuth認証

OAuthクライアントを設定し、取得したアクセストークンを使って認証を行います。

📄 ライセンス

MIT