presence-mcp

Launcher PyPI que expõe o modelo de projeto ativo e a telemetria de resultados do plugin presence do Claude Code como recursos MCP para Claude Desktop, Cursor e Continue.

GitHub
1
Experimente este MCPPatrocinado

Documentação

presence-mcp

PyPI Python versions License: Apache 2.0 CI MCP Registry

Lançador PyPI que expõe o modelo de projeto vivo e a telemetria de resultados do presence como recursos MCP para Claude Desktop, Cursor, Continue e outros clientes compatíveis com MCP.

presence é um plugin do Claude Code. Ele já inclui um servidor MCP stdio em lib/cli.py mcp e expõe dois recursos somente leitura por repositório (veja O que você obtém). Este pacote é o shim PyPI que permite que esse servidor seja listado no MCP Registry oficial e invocado com um único nome de comando em cada configuração por cliente, em vez de um caminho absoluto que varia por máquina.

O lançador em si não fala MCP. Ele localiza uma instalação local do presence e encaminha stdio para python lib/cli.py mcp. Cerca de 40 linhas de Python, apenas stdlib.

Início rápido

pip install presence-mcp

Em seguida, aponte qualquer cliente MCP para o comando presence-mcp. Para Claude Desktop, isso é:

{
  "mcpServers": {
    "presence": {
      "command": "presence-mcp"
    }
  }
}

Configuração completa por cliente para Cursor e Continue abaixo. Requer Python 3.12+ e uma instalação local do presence.

O que você obtém

Dois recursos MCP somente leitura, um por repositório em que você trabalhou:

URIConteúdoTipo MIME
presence://<repo_id>/modelmodel.md vivo (Markdown)text/markdown
presence://<repo_id>/telemetryReivindicações recentes de commit / revert / verificação (array JSON)application/json

<repo_id> é um prefixo SHA-256 de 12 caracteres do repositório. O servidor resolve o repositório atual a partir do diretório de trabalho do lançador; veja Ressalva sobre o diretório de trabalho. Esquema de recursos e detalhes do protocolo: docs/mcp.md do presence.

Configuração por cliente

O mesmo comando presence-mcp funciona em todos os clientes.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS), ou o equivalente no Windows / Linux:

{
  "mcpServers": {
    "presence": {
      "command": "presence-mcp"
    }
  }
}

Cursor

.cursor/mcp.json na raiz do projeto, ou as configurações globais de MCP do Cursor:

{
  "mcpServers": {
    "presence": {
      "command": "presence-mcp"
    }
  }
}

Continue

~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "presence",
      "command": "presence-mcp"
    }
  ]
}

Verifique a instalação

O lançador aceita JSON-RPC na entrada padrão. Colar {"jsonrpc":"2.0","id":1,"method":"initialize"} e pressionar Enter deve produzir uma resposta initialize. Você também pode invocá-lo como python -m presence_mcp se um script de console não for conveniente.

Variáveis de ambiente

VariávelFinalidade
PRESENCE_MCP_CLICaminho absoluto para o lib/cli.py do presence. Substitui a busca padrão por ~/.claude/plugins/presence/lib/cli.py. Se definido, mas o caminho não existir, o lançador gera erro em vez de recorrer ao padrão, para que erros de digitação apareçam.
PRESENCE_MCP_PYTHONInterpretador Python para executar o presence. O padrão é o sys.executable do próprio lançador. Útil quando o presence está instalado sob um Python diferente (por exemplo, um venv de projeto).

Se presence-mcp informar que não foi possível localizar o presence, instale o presence no caminho padrão do plugin do Claude Code ou defina PRESENCE_MCP_CLI.

Ressalva sobre o diretório de trabalho

O servidor MCP do presence resolve o repositório atual a partir do diretório de trabalho do lançador via git rev-parse --show-toplevel. Clientes MCP que iniciam o servidor a partir de um diretório fixo verão apenas um repositório. Para alternar repositórios, inicie uma instância separada por projeto (defina cwd na configuração por servidor do cliente) ou reinicie o servidor a partir da raiz do projeto de destino.

Compatibilidade

  • Python: 3.12 ou mais recente. A matriz de CI cobre 3.12 / 3.13 / 3.14.
  • presence: testado com >= 0.6.0. Versões mais antigas até v0.4.1 (onde o servidor MCP foi lançado pela primeira vez) podem funcionar, mas não são exercitadas pelo CI.
  • Plataformas: Linux e macOS exercitados no CI. Windows não é testado na v0.1.0. O lançador usa subprocess.run, que é multiplataforma, mas o caminho padrão de instalação do presence (~/.claude/plugins/presence/lib/cli.py) precisa de uma instalação real no Windows para confirmar. Relate problemas se você testar.

Este lançador é agnóstico de protocolo: ele não muda de versão quando o presence lança novos recursos MCP. Ele só muda de versão quando sua própria lógica de resolução, superfície de CLI ou conteúdo de server.json mudam.

Onde relatar problemas

  • Bugs do lançador (detecção de caminho, erros de instalação, encaminhamento de argumentos de CLI): issues neste repositório.
  • Bugs de conteúdo de recursos (o que presence://*/model retorna, esquema de telemetria, comportamento do diretório de trabalho, qualquer coisa sobre o protocolo em si): issues no repositório do presence.

Desambiguação

O servidor MCP do presence anuncia serverInfo.name = "presence-mcp" em sua resposta initialize. Essa é a identidade MCP do servidor. Este pacote é o lançador PyPI. Os nomes coincidem por intenção.

Links

Licença

Apache-2.0. Veja LICENSE e NOTICE.