remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides tools for searching, reading, updating, and commenting on issues in Linear's issue tracking system.

リニアMCPサーバー

線形統合用の MCP サーバーの Node.js 実装。

について

この MCP (モデルコンテキストプロトコル) サーバーは、AI モデルが線形問題追跡機能と対話するための標準化されたインターフェースを提供します。

主な特徴

公式MCP SDKを使用したLinearの標準MCPプロトコル実装
問題の検索、詳細の閲覧、更新、コメントのサポート

はじめる

前提条件

Node.js (v18以降)
リニアAPIキー

インストール

リポジトリをクローンする
依存関係をインストールする

npm install

ルートディレクトリにLinear APIキーを使用して.envファイルを作成します。

LINEAR_API_KEY=your_linear_api_key_here

サーバーの実行

サーバーを起動します。

npm start

ファイル監視を使用した開発の場合:

just dev

デバッグログを使用した開発の場合:

just debug

または、環境変数を手動で設定します。

LOG_LEVEL=DEBUG NODE_ENV=development node src/index.js

STDIO トランスポートへの干渉を避けるために、ログはlogs/mcp-linear.logファイルに書き込まれます。

MCP Inspectorと併用

サーバーは stdio モードで実行されるため、MCP Inspector を使用してサーバーに接続できます。

1 つのターミナルでサーバーを起動します。

npm start

Web ベースのインスペクターにアクセスしてください: https://inspector.modelcontextprotocol.ai
トランスポートタイプとして「stdio」を選択します
次のコマンドを入力します。

node /path/to/mcp-linear/src/index.js

「接続」をクリックして実行中のサーバーに接続します

Claude Desktopでの使用

Claude Desktop 構成ファイル (通常は~/.config/Claude Desktop/claude_desktop_config.json ) に次のコードを追加します。

{
  "mcp": {
    "servers": [
      {
        "name": "Linear",
        "command": "node /path/to/mcp-linear/src/index.js",
        "env": {
          "LINEAR_API_KEY": "your_linear_api_key_here"
        }
      }
    ]
  }
}

カーソルとの使用

カーソルの場合は、設定に以下を追加します。

{
  "ai.mcp.servers": [
    {
      "name": "Linear",
      "command": "node /path/to/mcp-linear/src/index.js",
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  ]
}

統合のテスト

セットアップを確認するには:

Claude DesktopまたはCursorの設定でMCPサーバーを設定します
アプリケーションを再起動してください
質問:「「バグ」を含む Linear の問題を検索」
アシスタントは、結果を取得するためにLinear MCPサーバーを検出して使用する必要があります。

プロジェクト構造

/
├── src/                     # Source code
│   ├── effects/             # Effects implementation
│   │   ├── linear/          # Linear API effects
│   │   │   └── types/       # Linear type definitions
│   │   └── logging/         # Logging effects for safe logging with STDIO
│   ├── tools/               # MCP tools implementation
│   │   ├── types/           # Tool type definitions
│   │   └── utils/           # Tool utility functions
│   ├── utils/               # Utility modules
│   │   └── config/          # Configuration utilities
│   └── index.js             # Main entry point
├── docs/                    # Documentation
│   └── llm_context/         # Documentation for LLMs
├── logs/                    # Log files (created at runtime)
└── package.json             # Project configuration

利用可能なツール

MCP サーバーは次のツールを公開します。

list_issues - さまざまなフィルタリングオプション (担当者、ステータスなど) を使用して、線形の問題 (チケットとも呼ばれます) を一覧表示します。
get_issue - IDで特定のLinearの問題に関する詳細情報を取得します
list_members - オプションで名前によるフィルタリングが可能な、線形チームメンバーの一覧を表示します。
list_projects - チーム、名前、アーカイブステータスによるフィルタリングオプション付きの線形プロジェクトを一覧表示します
get_project - 問題、メンバーなど、特定の Linear プロジェクトに関する詳細情報を取得します。
list_teams - メンバー、プロジェクト、問題の詳細を含む線形チームを一覧表示します
add_comment - 特定のLinearの問題にコメントを追加する
create_issue - カスタマイズ可能なタイトル、説明、優先度、担当者を指定して、Linear で新しい問題を作成します。

下位互換性のために、次のツールエイリアスも利用できます。

list_tickets - list_issuesのエイリアス
get_ticket - get_issueのエイリアス

トラブルシューティング

Linear MCP サーバーに問題がある場合:

リニアAPIキーを確認してください：.envファイルまたは環境変数に有効なリニアAPIキーが設定されていることを確認してください。リニアAPIキーは「lin api 」で始まる必要があります。
デバッグログを有効にする:a. MCP サーバーを起動する場合:
just debug # or LOG_LEVEL=DEBUG NODE_ENV=development node src/index.js
b. クライアント構成（Claude Desktop、Cursorなど）で：
"env": { "LINEAR_API_KEY": "your_linear_api_key_here", "LOG_LEVEL": "DEBUG" }
c. ツールを直接呼び出す場合は、デバッグパラメータを追加します。
{ "debug": true }
ログファイルを確認する: 詳細なエラー情報については、 logs/mcp-linear.logファイルのログを調べます。
Linear API アクセスを確認する: Linear API キーに適切な権限があり、Linear API に直接アクセスできることを確認します。

建築

アプリケーションはエフェクトベースのアーキテクチャに従います。

効果: 副作用のある操作は、 effectsディレクトリに分離されます。
- linear : 公式の Linear SDK を使用して Linear API へのアクセスを提供します
- logging : STDIOトランスポートを妨げない安全なロギング
ツール: 副作用に効果を使用する MCP ツールの実装:
- 各ツールはZodを使用した入力検証で一貫したパターンに従います。
- ツールはサーバー経由でMCPプロトコルを通じて公開されます
- 各ツールは線形効果を通じて線形クライアントにアクセスできます。
Utils : 設定と共通機能のためのユーティリティモジュール

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

AI モデルが Linear の問題追跡機能と対話し、問題の検索、詳細の読み取り、更新、コメントをサポートできるようにする Deno 実装。

Appeared in Searches

A Windows COM server for automating Windows tasks