Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

No warning when the MCP package and the Desktop Tools app are different versions

Aberta
  • Algo errado?
#179 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
48/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
json, macos, swift
Domínio
backend-api-design, desktop

Direção de pesquisa

The report points to the MCP connection flow, the app’s CFBundleShortVersionString, and the README; it does not name source files or tests. Start by tracing where the MCP server connects to the Desktop Tools app and reads app metadata. Done means version mismatches are surfaced to users and the README explains that updating the npx pin does not update the .app.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

What happened

Updating the pinned MCP package in ~/.claude.json:

"args": ["-y", "--package=github:githubnext/desktop-tools#v0.16.1",
         "desktop-tools-mcp"]

…updates only half of the install. /Applications/Desktop Tools.app stayed at
0.14.0, and the socket symlink points into that app bundle:

~/.local/state/desktop-tools/desktop-client -> /Applications/Desktop Tools.app/Contents/MacOS/desktop-tools-client

The MCP server started fine and handshook as desktop-tools 0.16.1, so there
was no indication anything was wrong until the first tool call:

HOST_NOT_SERVING: Desktop Tools isn't serving
~/.local/state/desktop-tools/desktop.sock, so nothing ran.

That message is accurate for "app not running", but it was also the only
symptom of "MCP updated, app did not". Installing the 0.16.1 DMG and launching
it fixed both.

Suggestions
  • On connect, compare the MCP package version with the app's
    CFBundleShortVersionString and surface a mismatch (warn, or include both
    versions in HOST_NOT_SERVING).
  • Consider mentioning in the README that updating the npx pin does not update
    the .app, since the app is what holds the macOS permissions.
Environment

MCP 0.16.1 via npx, app 0.14.0 then 0.16.1, macOS 27

Linguagem predominante
Swift
Estrelas
0
Forks
0
Merge médio
39min
PRs com merge (30d)
144

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de githubnext/desktop-tools

Todas as issues de githubnext/desktop-tools

Issues semelhantes

Mais issues de Swift

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.