pitwall-mcp

Name: pitwall-mcp
Author: sergioprats

作者：sergioprats版本 0.1.1i★ –i在你的电脑上运行

注册名称io.github.sergioprats/pitwall-mcp

安装

概览

作者提供的说明（英文原文）

Solo lectura sobre BMW CarData: mantenimiento, neumaticos y bateria de 12V. No afiliado a BMW AG.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 其他
你需要填写：PITWALL_CLIENT_ID, PITWALL_VIN, PITWALL_CONTAINER_ID

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： PITWALL_CLIENT_ID, PITWALL_VIN, PITWALL_CONTAINER_ID, PITWALL_TOKEN_FILE, PITWALL_DB_PATH, PITWALL_DAILY_QUOTA, PITWALL_LOG_LEVEL

标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。

你需要

PyPI已安装 Python 的 uv（用于 uvx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "pitwall": {
      "command": "uvx",
      "args": [
        "pitwall-mcp"
      ],
      "env": {
        "PITWALL_CLIENT_ID": "your-value",
        "PITWALL_VIN": "your-value",
        "PITWALL_CONTAINER_ID": "your-value",
        "PITWALL_TOKEN_FILE": "your-value",
        "PITWALL_DB_PATH": "your-value",
        "PITWALL_DAILY_QUOTA": "your-value",
        "PITWALL_LOG_LEVEL": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add pitwall --env PITWALL_CLIENT_ID=your-value --env PITWALL_VIN=your-value --env PITWALL_CONTAINER_ID=your-value --env PITWALL_TOKEN_FILE=your-value --env PITWALL_DB_PATH=your-value --env PITWALL_DAILY_QUOTA=your-value --env PITWALL_LOG_LEVEL=your-value -- uvx pitwall-mcp

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "pitwall": {
      "command": "uvx",
      "args": [
        "pitwall-mcp"
      ],
      "env": {
        "PITWALL_CLIENT_ID": "your-value",
        "PITWALL_VIN": "your-value",
        "PITWALL_CONTAINER_ID": "your-value",
        "PITWALL_TOKEN_FILE": "your-value",
        "PITWALL_DB_PATH": "your-value",
        "PITWALL_DAILY_QUOTA": "your-value",
        "PITWALL_LOG_LEVEL": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "pitwall": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pitwall-mcp"
      ],
      "env": {
        "PITWALL_CLIENT_ID": "your-value",
        "PITWALL_VIN": "your-value",
        "PITWALL_CONTAINER_ID": "your-value",
        "PITWALL_TOKEN_FILE": "your-value",
        "PITWALL_DB_PATH": "your-value",
        "PITWALL_DAILY_QUOTA": "your-value",
        "PITWALL_LOG_LEVEL": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

PITWALL_CLIENT_ID 机密必填 env
Client id de tu aplicacion BMW CarData, creada en https://bmw-cardata.bmwgroup.com. Se obtiene en el portal; no lo comparte nadie contigo.
PITWALL_VIN 机密必填 env
VIN del vehiculo, 17 caracteres. Debe estar mapeado como PRIMARY en la cuenta.
PITWALL_CONTAINER_ID 必填 env
Id del contenedor telematico creado por scripts/bootstrap_containers.py. El servidor solo lo consume: nunca crea ni borra contenedores.
PITWALL_TOKEN_FILE env
Ruta del fichero de tokens OAuth. Por defecto ~/.config/pitwall-mcp/tokens.json, con permisos 600 y fuera del repositorio.
PITWALL_DB_PATH env
Ruta de la base SQLite con la cache, el registro de cuota y el historico. Por defecto ~/.local/share/pitwall-mcp/pitwall.db.
PITWALL_DAILY_QUOTA env
Tope duro de peticiones REST al dia. BMW permite 50 cada 24 h por cuenta; el valor por defecto es 20 para dejar margen. Nunca puede superar 50.
PITWALL_LOG_LEVEL env
DEBUG, INFO, WARNING o ERROR. Los logs van a stderr: stdout es el canal MCP.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 sergioprats 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“其他”中的其他服务器比较i

星标数多于此分类中其他 18323 个服务器的 0%
发布到注册中心的时间比此分类中其他 18323 个服务器的 50% 更新
基础检查结果等于或优于此分类中其他 18323 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

pitwall-mcp 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：PITWALL_CLIENT_ID, PITWALL_VIN, PITWALL_CONTAINER_ID

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.1.1）于2个月前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。

有什么可以替代它？

同一分类中有：Spec Driven Development, Remote Desktop Commander, Date Math

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

作者：formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

在你的电脑上运行★ 440MIT14个月前更新

安装

Remote Desktop Commander

作者：desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

在云端运行★ 211前天更新

安装

Date Math

作者：JowenDelaPena

Exact date/time math for agents: business days, holidays, time zones, cron, RRULE, SLA. x402 paid.

在云端运行今天更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

pitwall-mcp

Servidor MCP local, de solo lectura, sobre la API BMW CarData de un BMW X1 sDrive18i (U11, gasolina, España).

Proyecto no afiliado a BMW AG. "BMW" y "CarData" son marcas de sus

respectivos propietarios. Este proyecto no está respaldado, patrocinado ni

revisado por BMW.

Le da a un asistente acceso a los datos de mantenimiento del coche — kilometraje, avisos CBS, presiones de neumáticos, batería de 12 V — sin que pueda tocar nada del vehículo, y sin agotar la cuota diaria de la API.

Qué se siente al usarlo

Le preguntas al asistente *"¿qué le toca al coche?"* y contesta con esto. Es una respuesta real, de la lectura del 16 de septiembre de 2026, recortada:

RESUMEN DE MANTENIMIENTO

Kilometraje: 48.731 km Proximo servicio en: 13460 km OJO: hay partidas CBS que BMW ya no marca como OK; no te fies solo de la cifra global: Frenos delanteros [PENDING]: 1.600 km.

Partidas CBS: 5

Frenos delanteros [PENDING]: 1.600 km
Aceite de motor [OK]: 14.000 km, hasta 2027-07
Inspeccion tecnica (ITV) [OK]: hasta 2027-01 conditionBasedServicesCount dice 9: es el maximo de avisos que este vehiculo puede transmitir, no los que tiene. El desglose trae 5, los transmitidos.

Prevision orientativa (calculo propio sobre los km de BMW, no un dato de BMW): Ritmo usado: 570 km/semana (media semanal que da BMW); tu historico local, 8 dias: 420. Se usa el mayor para no quedarse corto.

Frenos delanteros: 1.600 km, unas 2,8 semanas, hacia el 05-10-2026.

Bateria de 12V: Voltaje: 13.92 V (2026-09-14 13:49 UTC (hace 40 horas))

Dato mas antiguo utilizado: 2026-09-14 13:49 UTC (hace 40 horas). Procedencia: cache local. Lectura realizada: 2026-09-16 06:09 UTC.

Fíjate en lo que hace esa respuesta además de dar números: avisa de que la cifra global esconde lo urgente, traduce "1.600 km" a una fecha, admite que dos cifras de BMW no cuadran en vez de elegir una, y dice de cuándo es el dato más viejo que ha usado.

¿Te sirve a ti?

Sí si tienes un BMW con CarData activado y quieres saber qué cambia con el tiempo: cuándo vence cada cosa de verdad, si una rueda pierde aire, qué códigos de avería han aparecido desde la última vez.
No si buscas traducir códigos de avería, borrarlos o tocar cualquier ajuste del coche. Eso es terreno de un diagnóstico por OBD, no de esta API.
Ten en cuenta que es de uso ocasional. El dato crudo ya lo enseña la pantalla del coche; lo que aquí se añade es la serie, la previsión y los cambios.

Qué hace y qué no hace

Sí:

Lee datos telemáticos, datos básicos del vehículo y el diagnóstico de neumáticos, siempre a través de caché.
Guarda un histórico local en SQLite, para poder razonar sobre series y no sobre fotos puntuales.
Dice de dónde viene cada dato: timestamp de BMW, timestamp de la lectura, y si es API, caché o histórico.
Cuando un dato no existe, explica por qué no existe.

No, y no lo hará:

Ninguna herramienta escribe, manda, activa ni insinúa que puede actuar sobre el coche. CarData es una API de lectura.
Ninguna herramienta crea ni borra contenedores. Eso vive en un script que se lanza a mano.
No hay get_software_version: ese descriptor no existe en el catálogo de BMW. Lo único disponible es puStep, el paso de actualización de producto.

La cuota manda

La API REST de CarData está limitada a 50 peticiones cada 24 h y por cuenta. Pasarse devuelve 403 CU-429 hasta el día siguiente, y el contador es de BMW: incluye cualquier otra aplicación que use la misma cuenta.

Por eso:

Toda petición pasa obligatoriamente por caché y por un contador local.
El tope local por defecto es de 20 peticiones/día, para dejar margen.
Con un TTL de 12 h en el contenedor de mantenimiento, el uso normal son 2 peticiones al día.
search_descriptors y get_api_quota no gastan cuota nunca.

Consulta get_api_quota antes de encadenar llamadas.

Dato	TTL
`/telematicData` (contenedor de mantenimiento)	12 h
`/smartMaintenanceTyreDiagnosis`	7 días
`/basicData`	30 días
`/mappings`	30 días

Por qué esto y no la app oficial

La app te enseña el estado de hoy. Esto guarda cada lectura, así que puede comparar. Cuatro cosas concretas que salen de ahí, todas vistas en este coche:

Cuándo, no solo cuánto. La app dice "frenos delanteros, 1.600 km". El resumen dice unas 2,8 semanas, hacia el 5 de octubre, al ritmo real de uso, y avisa si una partida vence antes por kilómetros que por fecha.
La cifra global no basta, y aquí se ve. Con los frenos en PENDING a 1.900 km, serviceDistance.next marcaba 13.560. Quedarse con ese número habría escondido lo único urgente, así que toda partida que BMW no marque OK sale con un aviso propio.
Neumáticos sin confundir el calor con una fuga. El objetivo de presión de BMW no es fijo: se ha visto en 250 kPa en frío y en 290 con el neumático caliente. Comparar la presión de hoy con un objetivo de otro momento da un diferencial falso, así que cada rueda se compara con su pareja de eje en la misma lectura, que comparte temperatura y carga.
Qué cambia en la memoria de averías. El 18 de septiembre, entre dos lecturas, entraron 11 códigos y salieron otros 11: apareció una centralita entera y desaparecieron tres. Eso no se ve en ningún sitio si no guardas la lectura anterior.

Y lo que no aporta, para que no haya malentendidos:

No traduce los códigos de avería. Su significado no está en el catálogo de BMW; inventarlo sería peor que no darlo. Para eso está una herramienta de diagnóstico por OBD, del estilo de BimmerLink, que además los lee con su descripción y puede borrarlos.
No escribe nada. Ni codificación, ni resets, ni una sola orden al coche. Eso es terreno de BimmerCode y de un adaptador OBD, con el coche delante.
No inventa lo que no llega. Un dato ausente, uno presente pero vacío y un -NA- son tres cosas distintas, y las herramientas las distinguen en vez de enseñar un cero. De los 42 descriptores del contenedor, en la última lectura llegaron 28 con valor y 14 vacíos.

Herramientas

Herramienta	Gasta cuota	Estado
`search_descriptors(query, limit, include_electric)`	no	funciona
`get_api_quota()`	no	funciona
`list_vehicles()`	sí (1/mes con caché)	funciona
`get_vehicle_basic_data()`	sí (1/mes con caché)	funciona
`report_product_update_step()`	sí (comparte caché con `basicData`)	funciona, pero este vehículo no devuelve `puStep`
`get_telematic_data()`	sí (2/día con caché)	funciona
`get_vehicle_status()`	sí (comparte caché)	funciona
`get_tyre_diagnosis()`	sí (1/semana con caché)	funciona, pero este vehículo devuelve la estructura vacía
`get_maintenance_summary()`	sí (compuesta)	funciona
`diagnose_software_update()`	sí (compuesta, comparte caché)	funciona, con veredicto acotado
`get_fuel_status()`	sí (comparte caché)	funciona
`get_fault_memory()`	sí (comparte caché)	funciona; no traduce los códigos

Las dos herramientas marcadas con una reserva funcionan y declaran la ausencia: no rellenan el hueco con ceros ni con un valor plausible. puStep no llega en /basicData para este coche, y el diagnóstico de neumáticos vuelve con etiquetas y ceros de relleno que no son medidas.

get_vehicle_status() y get_maintenance_summary() muestran también los avisos Check Control, y añaden una línea OJO cuando alguna partida CBS deja de estar en OK. La cifra global de próximo servicio no basta: con los frenos delanteros en PENDING a 1.900 km, marcaba 13.560.

get_maintenance_summary() añade además, sin gastar peticiones, una previsión en semanas y fechas y la tendencia de presiones por eje. Las dos salen del histórico local, y el porqué de cada una está en Por qué esto y no la app oficial. La previsión usa la media semanal de BMW o la del histórico, la mayor de las dos, para no quedarse corta, y avisa cuando una partida vence antes por kilómetros que por fecha.

Dos herramientas más con datos que la app oficial no enseña:

`get_fuel_status()`: depósito y autonomía, los repostajes que detecta en el histórico y el consumo real desde el último. Solo da el consumo a partir de 300 km, y siempre con su margen, porque el aforador puede desviarse hasta 6 L. Muestra también el consumo homologado (OBFCM), pero como lo que es: una cifra de por vida que en este coche no se mueve desde octubre de 2024, no el consumo de hoy.
`get_fault_memory()`: la memoria de averías que el coche guarda para el taller, agrupada por centralita, y qué códigos aparecen o desaparecen entre lecturas. No traduce ningún código: su significado no está en el catálogo de BMW, y darlo sería inventarlo.

diagnose_software_update() razona sobre la serie del histórico, no sobre una foto. De las tres condiciones que BMW documenta para no ofrecer una actualización, CarData sólo permite observar una, y la herramienta declara las otras dos como NO OBSERVABLE POR CARDATA en lugar de razonar como si las hubiera descartado. Deja fuera cualquier voltaje de 13,5 V o más, porque eso es el alternador cargando y no dice nada de la batería en reposo. Si no le quedan al menos dos observaciones en reposo, responde SIN VEREDICTO y dice qué le falta. Y como isIgnitionOn llega vacío, avisa de que parte de cualquier pendiente puede ser sólo motor en marcha frente a motor parado, no una batería descargándose.

El informe local

El histórico que va guardando el servidor no se ve en ningún sitio: las herramientas contestan con la foto del momento, no con la serie. Para mirar la serie hay una página HTML que se genera a mano desde la SQLite:

.venv/Scripts/python.exe scripts/report.py              # captures/report-*.html

.venv/Scripts/python.exe scripts/report.py --full-vin # con el VIN entero

No gasta ninguna petición. No usa el token, no llama a ningún endpoint y no toca el contador de cuota: sólo lee la base de datos local. La página es un único fichero sin JavaScript ni dependencias externas, imprime bien, y sale con el VIN enmascarado a captures/, que está en .gitignore.

Lo primero que enseña no es un número, es cuántos de los 42 descriptores del contenedor traen valor de verdad, y en cuál de los tres estados vacíos está cada uno de los demás.

Instalación

Requiere Python 3.12+.

git clone https://github.com/sergioprats/pitwall-mcp

cd pitwall-mcp python -m venv .venv .venv/Scripts/python.exe -m pip install -e ".[dev]" # Linux/macOS: .venv/bin/python .venv/Scripts/python.exe scripts/refresh_catalogue.py

Ese último paso no es opcional: el catálogo telemático es un documento de BMW y este repositorio no lo redistribuye, así que hay que descargarlo una vez. Viene de zweckj/bmw-cardata (MIT), no de la API de CarData, de modo que no gasta ninguna petición de tu cuota. Los detalles están en spec/README.md.

Si instalas el paquete en vez de clonar el repositorio no tienes scripts/, así que el ejecutable trae lo imprescindible: `--fetch-catalogue` para el catálogo y `--login` para autenticarte. Lo que sigue necesitando el repositorio es crear el contenedor telemático, y es a propósito: ese paso escribe en tu cuenta de BMW y por norma del proyec

只显示了开头部分；其余内容请在仓库中阅读

pitwall-mcp

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

需要你填写的值

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

与“其他”中的其他服务器比较i

常见问题

替代选择

Spec Driven Development

Remote Desktop Commander

Date Math

作者的 README

pitwall-mcp

Qué se siente al usarlo

¿Te sirve a ti?

Qué hace y qué no hace

La cuota manda

Por qué esto y no la app oficial

Herramientas

El informe local

Instalación