youtrack-mcp

TypeScriptとBunで構築された、YouTrack用のMCPサーバーです。任意のYouTrackインスタンス（クラウドまたはセルフホスト）で動作します。ベースURLとAPIトークンを指定するだけで、ハードコードされたものはありません。

Setup

YouTrackのパーマネントトークンが必要です。YouTrackで、プロフィール → Account Security → New token... に移動してください。

2つの環境変数を設定します。

• YOUTRACK_BASE_URL — インスタンスのREST APIベースURL。例: https://mycompany.youtrack.cloud/api またはセルフホストの場合は https://youtrack.mycompany.com/api。

• YOUTRACK_TOKEN — パーマネントトークン。

Bunで依存関係をインストールします。

bun install

Run directly

YOUTRACK_BASE_URL=https://mycompany.youtrack.cloud/api YOUTRACK_TOKEN=perm:xxxx bun run src/index.ts

MCPクライアントでの設定

例: Claude Code / Claude Desktopのmcp.json内:

{
  "mcpServers": {
    "youtrack": {
      "command": "bun",
      "args": ["run", "/path/to/youtrack-mcp/src/index.ts"],
      "env": {
        "YOUTRACK_BASE_URL": "https://mycompany.youtrack.cloud/api",
        "YOUTRACK_TOKEN": "perm:xxxx"
      }
    }
  }
}

Related MCP server: YouTrack MCP

Tools

ツールはリソースごとにグループ化され、fields引数（YouTrackの部分レスポンス構文）を共有し、適切なデフォルト値を持ちます。そのため、より多くのデータまたは少ないデータが必要な場合にのみ指定するだけで済みます。

• Issues — list_issues（検索）、get_issue、create_issue、update_issue、delete_issue、execute_command（状態、担当者、優先度、リンク、タグ、スプリントなど、任意のYouTrackコマンドを自然なクエリ構文で適用します。例: "State Fixed assignee John.Doe"）

• Comments — list_issue_comments、add_issue_comment、update_issue_comment、delete_issue_comment

• Links — list_issue_links、list_issue_link_types

• Tags — list_tags、create_tag、list_issue_tags、add_issue_tag、remove_issue_tag

• Time tracking — list_issue_work_items、add_issue_work_item、update_issue_work_item、delete_issue_work_item、list_work_items

• Projects — list_projects、get_project、create_project、update_project、list_project_custom_fields

• Users & groups — get_current_user、list_users、get_user、list_groups

• Knowledge base — list_articles、get_article、create_article、update_article、delete_article

• Agile boards — list_agile_boards、get_agile_board、list_sprints、get_sprint

• Saved searches — list_saved_queries

• Escape hatch — youtrack_raw_requestは、YouTrack REST APIの任意のエンドポイントを直接呼び出します（メソッド、パス、クエリ、ボディ）。専用ツールでカバーされていない管理/設定エンドポイントのロングテール向けです。

Design

• src/youtrack/client.ts — HTTP通信を行う唯一の場所: 認証ヘッダー、URL/クエリ構築、JSON + エラーハンドリング。すべてのツールはこれを経由します。

• src/youtrack/fields.ts — エンティティごとのデフォルトのfieldsプリセット。YouTrack自身のOpenAPIデフォルトから取得。

• src/youtrack/params.ts — ツール間で再利用される共有Zodスキーマフラグメント（fields、ページネーション、ID）。

• src/tool.ts — defineTool + registerTools。各ツールファイルは名前/説明/スキーマ/ハンドラのみを宣言し、MCPのレスポンス/エラーラッピングは1か所で行われます。

• src/youtrack/tools/*.ts — リソースごとに1ファイル。各ツールは上記の共有部品を基に数行で構成されています。

Development

bun run typecheck   # tsc --noEmit
bun run dev         # run with --watch