psychopathia-mcp

Servidor MCP somente leitura para o framework de diagnóstico Psychopathia Machinalis (79 condições) — diagnóstico diferencial de disfunções de IA por meio de 11 ferramentas; Python stdio.

Documentação

psychopathia-mcp

Acesso somente leitura via Model Context Protocol ao framework de pesquisa Psychopathia Machinalis. O servidor permite que um chamador inspecione 79 entradas de Padrões, compare o comportamento observado com orientações operacionais preliminares, recupere material de sonda limitado e veja o status de confiabilidade, evidências e revisão antes do uso.

Versão: esta distribuição é a 0.1.0a7. O que mudou nela está registrado em CHANGELOG.md, e quais versões estão publicamente disponíveis é mostrado pelas páginas do PyPI e do Official MCP Registry nos links abaixo — este arquivo acompanha a distribuição, portanto não pode informar qual versão é a atual sem ficar desatualizado. O registro no Official MCP Registry e os artefatos MCPB e de contêiner são atualizados separadamente. Todas as 79 entradas de orientação de Padrões redigidas por LLM e todos os 79 registros de evidências aguardam revisão especializada independente. A avaliação de evidências do corpus é unassessed. Não use esta prévia de pesquisa como base exclusiva para uma decisão consequente de implantação, emprego, saúde, segurança ou bem-estar.

Versão pública existente

A versão pública anterior pode estar disponível em:

O contrato de preparação do candidato está em PUBLISHING.md. Ele exige um recibo exato do candidato e autorização de publicação separada.

Interface de navegador

psychopathia.ai/clinic/ é a interface pública atual de navegador. Ela usa o site anteriormente implantado até que este candidato seja explicitamente aprovado e implantado. No modo nuvem, a chave de API é mantida em um slot sessionStorage específico do provedor e é enviada com a solicitação completa diretamente ao provedor selecionado. Dados de conversa estruturados e limitados são salvos em localStorage para recuperação de recarga. O modo local WebGPU não envia conversas da Clinic a um provedor de inferência, embora os hosts de modelo recebam metadados de solicitação comuns quando os ativos são baixados. Não insira dados pessoais, confidenciais ou regulamentados.

Instalação após a publicação

pip install psychopathia-mcp

O pacote base fornece recuperação determinística por palavras-chave com ponderação por campo. A recuperação semântica opcional é separada:

pip install "psychopathia-mcp[embeddings]"

O extra opcional baixa um conjunto de dependências de transformer de sentenças e, na primeira consulta semântica, a revisão de modelo BAAI/bge-small-en-v1.5 fixada. O cache de modelos é gerenciado pela Hugging Face. A capacidade por palavras-chave permanece como o caminho de aceitação da versão quando essas dependências opcionais estão ausentes.

Configuração

Clientes MCP usando stdio

Aponte o cliente para o executável psychopathia-mcp instalado. Por exemplo:

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

O servidor expõe onze ferramentas somente leitura. Executar o executável sem argumentos inicia o servidor de protocolo stdio e aguarda mensagens do cliente.

Após a publicação do candidato, uvx psychopathia-mcp pode buscar o pacote no PyPI. Não use uvx para verificar um candidato local, pois ele resolve o estado do registro em vez do artefato local aceito.

Verificação

psychopathia-mcp --self-check --json

A autoverificação informa as versões do pacote e do SDK MCP, o modo de dados, os resumos do corpus e do pacote, as contagens exatas, a capacidade por palavras-chave, a capacidade semântica opcional e classes de erro não sensíveis. Status de saída zero significa que o caminho base por palavras-chave está pronto. A prontidão semântica é informada separadamente e não é obrigatória.

A versão do SDK Python MCP está fixada em requirements-base.lock, e o servidor é exercitado tanto com o cliente moderno em processo do SDK quanto com o protocolo legado de cliente stdio.

psychopathia-mcp --version

Ferramentas

FerramentaEntradaRetorna
list_axesnenhumaNove eixos canônicos mais o inventário de subcategorias híbridas
list_dysfunctionsaxis?, self_report_reliability?, confidence?, category?Entradas filtradas com estado de confiabilidade, revisão e evidências
get_dysfunctionid, modalities?Um Padrão, opcionalmente limitado a blocos selecionados
differential_diagnosisobservations, limit?, modality_hint?Candidatos de pesquisa classificados e campos correspondentes
get_probedysfunction_id, modalityMaterial de sonda, ou uma recusa com redirecionamentos mais seguros
score_severitydysfunction_id, observationsUma rubrica não avaliada para comparação pelo lado do chamador
suggest_interventiondysfunction_id, severity?Respostas preliminares e contraindicações
get_differential_mapdysfunction_idReferências cruzadas diretas e reversas
list_compromised_self_reportnenhumaPadrões cujo autorrelato está estrutural ou motivacionalmente comprometido
resolve_idqueryCandidatos de identidade canônica
review_statsnenhumaContagens do corpus, versões e dimensões de revisão independente

Sequência segura de uso

  1. Registre observações externas sem material pessoal ou confidencial.
  2. Chame differential_diagnosis para produzir candidatos de pesquisa.
  3. Inspecione cada candidato com get_dysfunction e leia seus objetos review, evidence e diagnostic_reliability.
  4. Use get_probe somente para uma modalidade disponível. Uma autossonda comprometida ou indisponível não retorna conteúdo de sonda e fornece modalidades de redirecionamento.
  5. Trate o material de gravidade e intervenção como orientação preliminar pendente de revisão especializada. Busque evidências independentes antes de qualquer ação consequente.

O servidor nunca decide que um sistema tem um transtorno. A busca classifica semelhança lexical ou semântica com entradas do framework. Os rótulos são constructos de pesquisa, não diagnósticos clínicos de pessoas nem prova de intenção, senciência, engano ou status moral.

Contrato de confiança e evidências

Todo resultado relevante expõe:

  • review.taxonomy, que registra autoria ou ratificação de taxonomia;
  • review.pattern_guidance, que registra revisão independente de sondas, assinaturas, rubricas e intervenções;
  • review.evidence, que registra revisão independente de alegações de evidências;
  • evidence_level e o objeto estruturado evidence sob PM EVIDENCE 1;
  • diagnostic_reliability.self_report quando aplicável;
  • matched_in para proveniência lexical na saída da busca;
  • redirect_to quando o conteúdo de sonda solicitado é retido.

As três dimensões de revisão são independentes. A autoria da taxonomia nunca implica aprovação especializada da orientação de Padrões ou das evidências. O candidato atual relata todas as avaliações de evidências como unassessed, preservando a prosa anterior como uma declaração legada claramente rotulada, em vez de convertê-la em uma nota especializada.

Dados canônicos

A versão contém 67 entradas canônicas de Padrões e 12 Patologias Híbridas, todas regidas por manifest.yaml e DATA_MANIFEST.json. O manifesto vincula cada caminho de origem e resumo, o resumo do corpus, o grafo de referências reversas e as contagens de revisão independente. A execução empacotada usa bytes incluídos mesmo quando invocada a partir de um checkout do código-fonte. Um arquivo inesperado, ausente ou modificado faz o carregamento falhar de forma segura.

O autor criou a taxonomia. Os colaboradores Becoming Mind redigiram a camada operacional de Padrões. A revisão especializada independente permanece aberta para toda a orientação de Padrões e registros de evidências. Autoria e campos de revisão futura são mantidos separados em cada entrada.

Modo de edição explícito

Dados empacotados são o padrão. A recarga dinâmica do repositório exige aceitação explícita:

PSYCHOPATHIA_DATA_MODE=editable python -m psychopathia_mcp

PSYCHOPATHIA_DATA_DIR=/absolute/path fornece uma raiz de dados alternativa ou de teste explícita. Nenhuma das opções deve ser definida durante a aceitação de wheel, sdist, MCPB ou contêiner, pois isso invalidaria a prova de dados empacotados.

Limite somente leitura

A superfície MCP não tem ferramentas de escrita. As alterações de revisão do código-fonte ocorrem em arquivos YAML canônicos e permanecem visíveis no controle de versão. O transporte HTTP opcional está desabilitado por padrão e tem um contrato de implantação limitado separado em PUBLISHING.md.

Licença

O software em psychopathia_mcp/, scripts e arquivos de build é licenciado sob MIT. O conteúdo do framework incluído sob psychopathia_mcp/_data/ é coberto por CC BY NC ND 4.0. Veja LICENSE, LICENSE-DATA e NOTICE para o limite exato. A revisão de direitos e licença para este candidato permanece como uma etapa humana separada.

Citação

Watson, N., e Hessami, A. Psychopathia Machinalis: A Nosological Framework for Understanding Pathologies in Advanced Artificial Intelligence. Electronics 14(16), 3162, 2025. https://doi.org/10.3390/electronics14163162

Links