youtrack-mcp

YouTrack용 MCP 서버로, TypeScript와 Bun으로 구축되었습니다. 모든 YouTrack 인스턴스(Cloud 또는 자체 호스팅)에서 작동합니다 — 기본 URL과 API 토큰만 제공하면 되며, 하드코딩된 것은 없습니다.

설정

YouTrack 영구 토큰이 필요합니다: YouTrack에서 프로필 → 계정 보안 → *새 토큰...*으로 이동하세요.

두 개의 환경 변수를 설정하세요:

• YOUTRACK_BASE_URL — 인스턴스의 REST API 기본 URL입니다. 예: https://mycompany.youtrack.cloud/api 또는 자체 호스팅 설치의 경우 https://youtrack.mycompany.com/api

• YOUTRACK_TOKEN — 영구 토큰입니다.

Bun으로 의존성을 설치하세요:

bun install

직접 실행

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

도구

도구는 리소스별로 그룹화되며, 합리적인 기본값이 있는 fields 인수(YouTrack의 부분 응답 구문)를 공유합니다. 따라서 더 많거나 적은 데이터를 원할 때만 지정하면 됩니다.

• 이슈 — list_issues(검색), get_issue, create_issue, update_issue, delete_issue, execute_command(자연스러운 쿼리 구문을 통해 상태, 담당자, 우선순위, 링크, 태그, 스프린트 등 모든 YouTrack 명령 적용, 예: "State Fixed assignee John.Doe")

• 댓글 — list_issue_comments, add_issue_comment, update_issue_comment, delete_issue_comment

• 링크 — list_issue_links, list_issue_link_types

• 태그 — list_tags, create_tag, list_issue_tags, add_issue_tag, remove_issue_tag

• 시간 추적 — list_issue_work_items, add_issue_work_item, update_issue_work_item, delete_issue_work_item, list_work_items

• 프로젝트 — list_projects, get_project, create_project, update_project, list_project_custom_fields

• 사용자 및 그룹 — get_current_user, list_users, get_user, list_groups

• 지식 베이스 — list_articles, get_article, create_article, update_article, delete_article

• 애자일 보드 — list_agile_boards, get_agile_board, list_sprints, get_sprint

• 저장된 검색 — list_saved_queries

• 이스케이프 해치 — youtrack_raw_request는 전용 도구로 다루지 않는 관리자/설정 엔드포인트(롱테일)를 위해 YouTrack REST API의 모든 엔드포인트를 직접 호출합니다(메서드, 경로, 쿼리, 본문).

설계

• src/youtrack/client.ts — HTTP 통신을 담당하는 유일한 곳: 인증 헤더, URL/쿼리 구성, JSON 및 오류 처리. 모든 도구가 이곳을 거칩니다.

• src/youtrack/fields.ts — YouTrack 자체 OpenAPI 기본값에서 가져온 엔티티별 기본 fields 프리셋.

• src/youtrack/params.ts — 도구 전반에서 재사용되는 공유 Zod 스키마 조각(fields, 페이지네이션, ID).

• src/tool.ts — defineTool + registerTools. 각 도구 파일은 이름/설명/스키마/핸들러만 선언하고, MCP 응답/오류 래핑은 한 곳에서 처리됩니다.

• src/youtrack/tools/*.ts — 리소스당 하나의 파일, 각 도구는 위의 공유 구성 요소를 기반으로 몇 줄로 작성됩니다.

개발

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