issueport

issueport

Linear のチーム、プロジェクト、課題、コメントを、Linear GraphQL API と通信する MCP ツールとして提供します。issueport は、Linear MCP の機能の中核部分をクリーンルーム方式で再構築したもので、新しい名前を使用しています。Linear の公開 API ドキュメントをもとに新たにコードを作成しており、ブランド要素のコピーはありません。元の Linear サーバーは OAuth を使用するホスト型／リモート型ですが、この再構築版は API キーを使用する、同じ上流 API 向けの GraphQL クライアントであり、ホスト型 OAuth の機能は再現しません。

ツール（中核部分、12個）

list_issues、get_issue、create_issue、update_issue、 search_issues、list_teams、get_team、list_projects、 create_project、list_comments、create_comment、archive_issue。

この機能範囲に含まれないもの：サイクル、ドキュメント、ファイルアップロード、Webhook、OAuth アプリ、時間追跡、トリアージ／カスタムワークフロー管理、プロジェクトのマイルストーン／ラベル管理、添付ファイル、通知。

各ツールは、{query, variables} として送信される GraphQL オペレーション（クエリまたはミューテーション）を1つ実行します。GraphQL の errors 配列が返された場合、最初のエラーのメッセージを使って呼び出しは失敗します。

セットアップ

export LINEAR_API_KEY=lin_api_...

注：Linear API キーは Bearer トークンとしてではなく、そのまま Authorization ヘッダーの値として送信します。必要に応じて、LINEAR_API_URL でエンドポイントを上書きできます（デフォルトは https://api.linear.app/graphql）。キーが設定されていない場合、すべてのツール呼び出しは、不足している変数名を示すエラーで失敗します。

CLI

npx @reneturcios/issueport get_issue '{"issue_id":"..."}'
npx @reneturcios/issueport mcp        # stdio MCP server

各ツール名はサブコマンドであり、1つの JSON オブジェクト引数を取ります。

MCP クライアント設定

{
  "mcpServers": {
    "issueport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/issueport", "mcp"],
      "env": { "LINEAR_API_KEY": "lin_api_..." }
    }
  }
}

Docker

docker run -i -e LINEAR_API_KEY ghcr.io/cloudcorprecords/issueport

開発

npm install
npm run build
npm test

ライセンス

MIT