convez.ai
MCP ServerIntegração & APIsIntermediário
jasonsteinman

Jason-MCP: Servidor YouTrack para Claude

jasonsteinman/youtrack-mcp

YouTrack automatizado para Claude: sprints, issues e relatórios sem burocracia

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP especializado para integrar JetBrains YouTrack com Claude, oferecendo gerenciamento de sprints, issues, relatórios de squad e notificações. Resolve nomes de pessoas, campos customizados e operações comuns de forma simples, sem se prender a objetos API frágeis.

Instalação

$npx convez-ai jasonsteinman/youtrack-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
1
Contribuidores
8

Casos de uso

  • Atualizar status e prioridade de issues por voz/texto
  • Gerar relatórios de story points por desenvolvedor ou squad
  • Automatizar movimentação de issues entre sprints
  • Resolver nomes de pessoas e atribuir issues com linguagem natural
  • Monitorar notificações e menções no YouTrack
  • Criar e linkar issues, adicionar comentários e anexos via Claude

Veredito

MCP robusto e bem pensado para equipes que usam YouTrack. Resolve problemas reais (nomes em vez de IDs, campos customizados sem erros, limpeza de campos) e oferece operações de sprint que faltam no MCP oficial. Recomendado para times DevOps/Agile que querem automatizar gestão de projetos.

README

A tradução para o português deste README ainda está na fila.

Jason-MCP

A well-functioning YouTrack MCP for people who hate doing YouTrack busywork.

Sprints, squad reports, name-aware actions, and the notifications inbox the official one forgot.


Jason-MCP is a Model Context Protocol server that lets Claude (and any MCP client) drive JetBrains YouTrack — read and write issues, move sprints, report story points per developer/squad, assign people by name, and check what's waiting on you. It speaks plain strings, not fragile API objects, so the common operations just work.

New here / setting it up for a teammate? → docs/INTRODUCTION.md — the one-page pitch · docs/INSTALL.md — install & connect in ~10 min · skills/README.md — the one-word skills pack.

✨ What's fine-tuned here

Beyond the standard YouTrack tools, Jason-MCP adds:

  • 🗂️ Schema-aware custom fields — field types are read from the issue itself, so any State/enum/user field updates correctly (no more StateBundleElement type errors), and fields can actually be cleared (unassign everyone in one call).
  • 🏃 Sprint operations — move issues between sprints, roll sprints over, fetch sprint contents.
  • 📊 Team reporting — story points per developer and per squad.
  • 🙋 Name-aware actions — assign, set reviewer, and @-mention people by display name, not just login. Jason-MCP resolves the name for you.
  • 🔔 Notifications inbox — surface mentions and comment activity the official MCP doesn't expose.

See FINE_TUNED_FEATURES.md for the full list, and BLOCKED_OPERATIONS.md for the custom-field fixes and why they were needed.

🚀 Quick reference — common operations

These use the proven simple-string format. Pass plain strings, not nested objects.

State, priority, assignee, type, estimation

update_issue_state("DEMO-123", "In Progress")
update_issue_priority("DEMO-123", "Critical")
update_issue_assignee("DEMO-123", "john.doe")     # or a display name: "John Doe"
update_issue_type("DEMO-123", "Bug")
update_issue_estimation("DEMO-123", "4h")          # 30m · 4h · 2d · 1w · "3d 5h"

Custom fields (and clearing them)

# Set several at once
update_custom_fields("DEMO-123", {"Priority": "Critical", "Type": "Bug"})

# Clear fields — None empties them (unassign everyone, blank the squad, etc.)
update_custom_fields("DEMO-123", {
    "Assignee": None,
    "Reviewer": None,
    "Squad": None,
})
update_issue_assignee("DEMO-123", "unassigned")    # also clears the assignee

Finding, creating, linking, commenting

search_issues("bug in login")
get_project_issues("DEMO")
get_issue("DEMO-123")

create_issue(project_id="DEMO", summary="Bug in login system",
             description="Users cannot log in with special characters")

add_dependency("DEMO-123", "DEMO-124")
add_relates_link("DEMO-123", "DEMO-125")

add_comment("DEMO-123", "Fixed the login bug")
get_issue_comments("DEMO-123")

Attachments

get_issue_raw("DEMO-123")                          # raw data incl. attachments
get_attachment_content("DEMO-123", "1-456")        # download as base64
delete_attachment("DEMO-123", "1-456")             # needs permission

# Upload a local file, optionally with a comment that links to it.
# Only files inside YOUTRACK_ATTACHMENT_ALLOWED_DIRS (default ~/youtrack-uploads/*/inbox and
# ~/youtrack-uploads/*/outbox) are accepted; '..', symlinks leaving those folders and files over
# YOUTRACK_ATTACHMENT_MAX_MB (default 20) are rejected.
add_attachment("DEMO-123", "/home/bot/youtrack-uploads/t1/inbox/data.csv", comment="Export")

Search (paginated, compact) and Knowledge Base

search_issues("project: DEMO #Unresolved")                    # 20 compact issues + has_more/next_offset
search_issues("project: DEMO", limit=50, offset=50)           # next page
search_issues("project: DEMO", fields="id,summary,Squad,description")  # pick fields; "full" = everything
get_article("KB-A-12")                                        # article title, content, parent, attachments

🛠️ Install & run (from source)

Jason-MCP runs straight from this repo over stdio — no Docker or npm package required.

git clone https://github.com/jasonsteinman/youtrack-mcp.git
cd youtrack-mcp

python -m venv .venv
source .venv/bin/activate          # Windows: .venv\Scripts\activate
pip install -r requirements.txt

Set your credentials (or put them in a .env file — it's auto-loaded):

export YOUTRACK_URL="https://your-instance.youtrack.cloud"
export YOUTRACK_API_TOKEN="perm-XXXXXXXX..."

Then run it:

python main.py                     # stdio (default, for MCP clients)
python main.py --transport sse --port 8000   # or SSE over HTTP
python main.py --version

Wire it into Claude

Add Jason-MCP to your MCP client config (e.g. Claude Desktop / Claude Code), pointing at this repo's main.py:

{
  "mcpServers": {
    "youtrack": {
      "command": "python",
      "args": ["/absolute/path/to/youtrack-mcp/main.py"],
      "env": {
        "YOUTRACK_URL": "https://your-instance.youtrack.cloud",
        "YOUTRACK_API_TOKEN": "perm-XXXXXXXX..."
      }
    }
  }
}

⚙️ Configuration

VariablePurpose
YOUTRACK_URLYour YouTrack instance URL
YOUTRACK_API_TOKENYour YouTrack permanent API token
YOUTRACK_VERIFY_SSLSSL verification (default: true)
ENABLED_TOOLSAllowlist — enable only these tools (disables all others)
DISABLED_TOOLSDenylist — disable specific tools

Tool filtering keeps context lean. Tool names are case-insensitive and treat -/_ the same; ENABLED_TOOLS wins over DISABLED_TOOLS. Filtering happens at startup.

export ENABLED_TOOLS="get_issue,search_issues,update_issue_state"   # allowlist
export DISABLED_TOOLS="delete_issue,delete_attachment"              # denylist

🧪 Development

pip install -r requirements.txt
python -m pytest tests/unit -q          # run the unit suite

The custom-field fixes are covered by tests/unit/test_custom_field_schema_aware.py.

🐱 About the name

Jason-MCP. The kittens are just here for morale.

💬 Support

Questions, bugs, or ideas? Open an issue or reach me at maintainer@example.com.


Forked from tonyzorin/youtrack-mcp and fine-tuned. Thanks to the original author for the foundation.

Ver o original no GitHub

Bom para

Relacionados