Linear MCP Server

🚀 線形MCPサーバー

線形GraphQL APIを実装したMCP（モデルコンテキストプロトコル）サーバーです。これにより、AIアシスタントが線形プロジェクト管理システムとやり取りできるようになります。

🚀 クイックスタート

線形MCPサーバーは、AIアシスタントが線形プロジェクト管理システムとシームレスにやり取りできるようにします。MCPプロトコルを統合することで、ユーザーは簡単にプロジェクト、タスク、チームメンバーを管理できます。

✨ 主な機能

• MCPツールを通じて線形GraphQL APIにアクセスする
• 線形APIキーを使用して認証する
• ユーザー、チーム、プロジェクト、問題に関連するデータを取得および変更する
• 問題を作成、更新、コメントする
• ラベルを追加および削除する
• プロジェクトを作成する
• 完全なツールドキュメントを提供する

📦 インストール

Smithery経由でのインストール

1. Smitheryウェブサイトにアクセスしてログインします。
2. 「サーバーを追加」セクションで線形MCPサーバーを見つけます。
3. 指示に従ってインストールと設定を完了します。

手動インストール

npm install --save @emmett-deen/linear-mcp-server

🔧 設定

.envファイルを作成し、以下の内容を追加します。

PORT=8080  # オプション、デフォルトは3000
API_KEY=your_api_key_here

サーバーの起動

node index.js

💻 使用例

基本的な使用法

// 問題を作成する
const { createIssue } = require('@emmett-deen/linear-mcp-server');

createIssue({
  title: '修复登录问题',
  description: '需要在周五前解决此问题。',
  assignee: 'john.smith@example.com',
  labels: ['bug', 'high-priority']
});

高度な使用法

Claude Desktopと接続した後、以下のようなプロンプトを使用できます。

• 「すべての線形問題を表示」
• 「フロントエンドチームに、タイトルが「修复登录bug」の新しい問題を作成」
• 「問題FE - 123の状態を「進行中」に変更」
• 「問題BE - 456をJohn Smithに割り当て」
• 「問題UI - 789にコメントを追加：「この問題は金曜日までに解決する必要があります」」

📚 ドキュメント

前提条件

• Node.jsバージョン12以上
• npmバージョン6以上
• 線形APIキー

インストール手順

依存関係のインストール

npm install

サーバーの実行

node index.js --token your_api_token_here

Claude Desktopでの設定

1. Claude Desktopの設定を開きます。
2. 新しい接続を追加し、線形MCPサーバーをプロバイダーとして選択します。
3. サーバーアドレスとAPIキーを入力します。

🔧 技術詳細

開発環境のセットアップ

git clone https://github.com/yourusername/linear-mcp-server.git
cd linear-mcp-server
npm install
npm run dev -- --token your_api_token_here

サーバーの拡張

1. TOOLS.mdドキュメントの実装ガイドを参照します。
2. srcディレクトリの既存のコード構造に従うことを確認します。
3. 変更を反映するようにドキュメントを更新します。

貢献と開発

開発環境のセットアップ

git clone https://github.com/yourusername/linear-mcp-server.git
cd linear-mcp-server
npm install
npm run dev

npmへの公開

1. package.jsonのバージョンを更新します。

npm version patch  # または minor、major

2. プロジェクトをビルドします。

npm run build

3. npmにログインしていることを確認します。

npm login

4. npmに公開します。

npm publish --access public

5. Smitheryレジストリの場合は、Smitheryチームに連絡して、サーバーをディレクトリに登録してもらいます。

📄 ライセンス

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