ev-diagnosis-mcp

ev-diagnosis-mcp

Serviço MCP para diagnóstico de manutenção de veículos de nova energia. Fornece aos clientes de IA o que falta nos modelos genéricos: experiência prática em manutenção de veículos de nova energia em chinês, o fluxo completo de código de falha para causa e orçamento, e associações de alta incidência por modelo de veículo.

Zero dependências de terceiros, dados 100% locais, sem conexão com a internet, sem chamadas de modelo, sem envio de dados.

English: README_EN.md

Veja exemplos reais de saída online (sem instalar): https://ev-intake.app.workbuddy.host/demo.html

---

O que ele resolve

Modelos de linguagem genéricos respondem "a autonomia do BYD Han EV cai rápido no inverno" com uma lista de possíveis causas estilo livro didático. O que realmente tem valor é este tipo de conteúdo:

Após períodos chuvosos/áreas alagadas, falhas de isolamento são frequentes; a maioria decorre de água nos conectores, não na bateria em si. Priorize a verificação do chicote elétrico e das interfaces. Falhas de isolamento na Tesla geralmente são causadas por impacto na parte inferior ou entrada de água na porta de carregamento; medição segmentada com megôhmetro é a melhor abordagem.

Esse tipo de conhecimento não está nos dados genéricos de treinamento; vem do campo de manutenção. Este serviço transforma 190 dessas experiências em dados pesquisáveis, além de 896 definições padrão de códigos de falha, 146 entradas de manutenção em chinês e 44 mapeamentos de problemas comuns por modelo.

Instalação

npx -y ev-diagnosis-mcp      # 直接用（已发布后）
node server.mjs              # 本地源码

Configuração do cliente:

{
  "mcpServers": {
    "ev-diagnosis": {
      "command": "npx",
      "args": ["-y", "ev-diagnosis-mcp"]
    }
  }
}

Exemplo completo em mcp-config.example.json. Suporta protocolo MCP 2024-11-05 / 2025-03-26 / 2025-06-18.

Ferramentas (7)

Ferramenta	O que faz	Dados
diagnose_full	Insira modelo + sintoma + código de falha, obtenha conclusão direta: ranking de probabilidade de causa, ordem de verificação (primeiro o que não gasta, depois o que gasta), faixas de orçamento, associações de alta incidência por modelo, explicação em linguagem simples para o proprietário	Consolidado
lookup_fault_code	Consulta de código de falha: exato / prefixo / palavra-chave em chinês. Retorna causa, etapas de diagnóstico, solução, tempo de mão de obra, orçamento, peças, armadilhas a evitar	146 entradas
lookup_dtc	Definição padrão de código de falha: texto original em inglês + tradução técnica em chinês + fabricante, e indica se há entrada de manutenção em chinês na base	896 entradas
search_experience	Busca de experiência prática de técnicos experientes, por palavra-chave, sem restrição a código de falha	190 entradas
list_model_issues	Problemas comuns por modelo: associação modelo × código de falha	44 entradas
symptom_to_codes	Consulta reversa de sintoma para código de falha	40 entradas
kb_stats	Tamanho dos dados, origem e nível de confiabilidade de cada conjunto de dados	—

Também fornece resources (kb://datasets, kb://provenance, kb://fault-codes, kb://dtc-index, kb://experience) e 2 prompts (diagnose_intake, owner_explain).

Como é a saída

Saída real de diagnose_full({"brand":"特斯拉","model":"Model 3","symptom":"涉水后无法上电，仪表报高压系统故障","extra":"昨晚暴雨，涉水深度约20cm"}) (trecho):

## 可能原因（按概率排序，启发式估计，非统计值）
1. 高压线束破损对地 — 约 21%
2. 涉水导致连接器进水 — 约 18%
3. 电池包内部绝缘下降 — 约 15%

## 检查与处理顺序（先不花钱的，后花钱的）
1. [排查·几乎不花钱] 用绝缘检测仪测整包正/负对地绝缘阻值(标准>500Ω/V)
2. [排查·几乎不花钱] 分段断开高压部件(电池、MCU、OBC、压缩机)分别测量定位漏点
...
6. [维修·换密封件 500-2000 元] 断开维修开关MSD并验电

## 报价分档
- 换密封件：500 - 2000 元
- 换 OBC：3000 - 8000 元
- 换壳体/拆包：8000 - 20000 元

## 老师傅经验
- P0AA6：雨季/涉水后绝缘故障高发，多数源于连接器进水而非电池本体，优先查线束与接口。
- P0AA6：特斯拉绝缘故障多为底部磕碰或充电口进水，分段兆欧表测量是王道。

## 可以直接发给车主的一段话
您这车出现「涉水后无法上电，仪表报高压系统故障」，最常见的原因是高压线束破损对地，
大概 21% 的可能性（经验排序，不是统计值）。处理上会先用绝缘检测仪测整包正/负对地绝缘阻值，
这一步基本不花钱；确认不了再往下查。费用大概 500 到 20000 元，具体看坏在哪一档，修之前会跟您确认。
高压部分要断电验电后再动，我们自己不会带电操作。

Origem dos dados e confiabilidade

Isso precisa ficar claro, caso contrário não dá para avaliar o quanto confiar nas conclusões. Use kb_stats para consultar a qualquer momento:

Conjunto de dados	Quantidade	Origem	Nível
Definições padrão de código de falha	896	ModelScope Never84/Vehicle_DTC_Diagnostic_Trouble_Code_Definitions, Apache 2.0	A
Modelos e tipos de bateria	34	Parâmetros públicos de veículos	A
Base de manutenção de código de falha em chinês	146	Base de conhecimento de manutenção da equipe (inclui normas nacionais e manuais públicos de montadoras)	B
Experiência prática de técnicos experientes	190	Acúmulo da base de conhecimento de manutenção da equipe	B
Problemas comuns por modelo	44	Acúmulo da base de conhecimento de manutenção da equipe	B
Sintoma → código de falha	40	Acúmulo da base de conhecimento de manutenção da equipe	B
Peças de uso comum	56	Informações públicas de peças	B

• A = conjunto de dados público ou ordens de serviço reais, rastreável
• B = organização estruturada, campos preenchidos conforme convenções do setor, não validado veículo por veículo
• C = dados de exemplo (não incluídos nesta versão)

As probabilidades em diagnose_full são ordenação heurística (se experiência e problemas comuns corroboram, custo de investigação), não são probabilidades estatísticas, e isso está indicado na saída. Os orçamentos são faixas praticadas no setor e precisam ser calibrados conforme ano/modelo do veículo e oficina real.

Após importar ordens de serviço reais, as entradas são marcadas como source=real_workorder, o nível sobe automaticamente para A e são contadas separadamente em kb_stats. Script de importação: tools/import_workorders.py (CSV / Excel / JSON).

A saída deste serviço é referência auxiliar de manutenção e não constitui conclusão de reparo. Trabalhos em alta tensão devem ser executados por pessoal qualificado seguindo os manuais das montadoras.

Testes

npm test        # 或 node test.mjs

37 asserções: handshake do protocolo, lista de ferramentas, chamada real das 7 ferramentas, resources, prompts, entradas inválidas (ferramenta desconhecida / método desconhecido / entrada vazia). Atualmente tudo verde.

Veja uma saída individual: node preview.mjs diagnose_full '{"brand":"比亚迪","model":"汉EV","symptom":"冬天续航掉得快"}'

Publicação em diretórios

Requer contas no GitHub e npm (GITHUB_USER neste repositório é um placeholder; use python tools/prepare_release.py --user <你的GitHub用户名> para substituir com um clique):

1. MCP Registry oficial: mcp-publisher init → login com GitHub → mcp-publisher publish. Outros diretórios geralmente sincronizam a partir dele; o namespace io.github.<用户名>/ev-diagnosis não pode ser alterado depois de definido
2. npm: npm publish --access public
3. Glama: adicione o tópico mcp-server ao repositório, que é rastreado automaticamente
4. mcp.so / Smithery / LobeHub / Awesome MCP Servers / Cline Marketplace: veja delivery/publish/市场提交文案.md

Roadmap

• Recalcular níveis após importação de ordens de serviço reais, substituindo gradualmente dados classe B por classe A
• Expandir problemas comuns por modelo de 44 para mais de 200 entradas (com base em ordens de serviço reais, não em dados inventados)
• Autenticação e cobrança (atualmente totalmente aberto; implementar quando houver usuários)

Licença

Código: MIT. Dados: as 896 entradas de códigos padrão vêm de conjunto de dados Apache 2.0; o restante é base de conhecimento da equipe, permitido para uso neste serviço.