CommunityProgramación y desarrollogithub.com

stkoecn/im-mcp

Guía de operación y mantenimiento del servicio MCP para la mensajería local de WeChat y DingTalk en Windows/macOS, incluyendo historiales de chat, contactos, grupos y recuperación de archivos.

¿Qué es im-mcp?

Esta habilidad proporciona una guía completa para que los agentes de IA gestionen el ciclo de vida completo de los datos de las herramientas `im-mcp` (que cubren WeChat y DingTalk) en entornos Windows y macOS. Define estrategias de ejecución claras, como la instalación persistente con `uv tool install` o la ejecución ad hoc mediante `uvx` para entornos restringidos, y detalla los comandos esenciales (`wechat-init`, `dingtalk-init`, `im-clean`) para la inicialización, descifrado y limpieza segura de bases de datos de chat. La guía enfatiza la importancia de la seguridad y la privacidad, prohibiendo explícitamente al agente escanear procesos de forma indiscriminada o escribir código de prueba no autorizado. En su lugar, el agente debe guiar al usuario paso a paso, identificar automáticamente el entorno del cliente (Pi, Claude Desktop, Cursor, etc.) y proporciona instrucciones de activación específicas, junto con ejemplos de uso en lenguaje natural para que la experiencia del usuario sea fluida. Además, incluye un protocolo completo de informes de errores y un proceso de actualización sin problemas.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/stkoecn/im-mcp/tree/HEAD/skills/im-mcp

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Guía de operación y mantenimiento del agente IM-MCP y gestión del ciclo de vida de datos

Esta habilidad guía al agente en la gestión del conjunto de herramientas im-mcp (que incluye WeChat MCP y DingTalk MCP) en entornos Windows y macOS, abarcando verificación del entorno previo, inicialización y descifrado de bases de datos fuera de línea, recuperación de datos de chat y limpieza segura después de completar la tarea.


1. Posicionamiento central y estrategia de ejecución (Core Principles & Execution Strategy)

1.1 Principio de prioridad del método de ejecución y estrategia de ejecución

Al guiar o ayudar al usuario en el despliegue, el agente debe seguir la siguiente estrategia de ejecución:

  1. Instalación persistente prioritaria: en entornos de cliente de escritorio como Claude Desktop, Cursor o que admitan herramientas persistentes, se recomienda usar uv tool install "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]";
  2. Degradación en entornos limitados/restringidos: si el entorno actual del cliente de IA (como el entorno limitado Pi) intercepta la instalación global de herramientas (mostrando Blocked ... use uvx), debe seguir directamente la política de seguridad de ese entorno y usar el método uvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" para ejecutar los comandos correspondientes de forma ad hoc;
  3. Alternativa de espejo de red nacional (fuente Gitee): si el usuario se encuentra en un entorno de red nacional o tiene acceso limitado/lento a GitHub, puede reemplazar directamente la dirección Git anterior por el repositorio espejo de Gitee:
    • Persistente: uv tool install "git+https://gitee.com/ws4m/im-mcp.git" --with "im-mcp[all]"
    • Ad hoc: uvx --from "git+https://gitee.com/ws4m/im-mcp.git[all]" <comando>
  4. Prohibición de escribir código de prueba de protocolo sin autorización: después de instalar y ejecutar la inicialización (wechat-init y dingtalk-init), está estrictamente prohibido escribir scripts o código para simular pruebas de protocolo JSON-RPC/stdio de bajo nivel sin autorización; debe entregarse directamente al usuario y proporcionar orientación sobre cómo habilitarlo en el cliente;
  5. Percepción del entorno anfitrión y guía de entrega: el agente debe, según el entorno de cliente en el que se esté ejecutando (como Pi, Claude Code/Desktop, Cursor, Cline, etc.), determinar de forma autónoma e indicar al usuario los pasos específicos para habilitar la Skill y el MCP (como indicar que ingrese /reload, reinicie el cliente o active la confianza en la barra lateral), y proporcionar directamente 1 o 2 ejemplos de uso para la conversación diaria.

1.2 Matriz de comandos y resumen de permisos

# Modo A: Instalación de la cadena de herramientas CLI con aislamiento persistente global (se recomienda priorizar)
uv tool install "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]"

La matriz de comandos es la siguiente:

ComandoMétodo de invocación después de la instalación globalMétodo de ejecución ad hoc uvx en entorno limitado/restringidoEscenario de aplicaciónRequisito de permisoProducto clave / Ruta
wechat-initwechat-inituvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" wechat-initExtraer DBKey de WeChat y descifrar sin conexión a base de datos SQLiteWindows requiere permisos de administrador (lectura de memoria); macOS admite --passphrase o configuración persistente~/.wechat_mcp/decrypted/, ~/.wechat_mcp/app.db
dingtalk-initdingtalk-inituvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" dingtalk-initExtraer clave de DingTalk sin conexión, descifrar DB y fusionar transacciones WALPermisos de usuario normal~/.dingtalk_mcp/decrypted/dingtalk.db
im-cleanim-cleanuvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" im-cleanLimpieza segura con un solo clic de todos los datos de texto plano, claves y caché exportadosPermisos de usuario normal/administradorLimpia las bibliotecas descifradas de ambos y el directorio de datos global
wechat-mcpwechat-mcpuvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" wechat-mcpPunto de entrada estándar del servidor FastMCP para WeChatPermisos de usuario normalInterfaz stdio
dingtalk-mcpdingtalk-mcpuvx --from "git+https://github.com/stkoecn/im-mcp.git[all]" dingtalk-mcpPunto de entrada estándar del servidor FastMCP para DingTalkPermisos de usuario normalInterfaz stdio

2. Flujo de trabajo de operación del agente (Lifecycle Workflows)

2.1 Antes de comenzar la tarea: Inicialización automática de la base de datos (Pre-flight Initialization)

Cuando el usuario solicite "analizar la comunicación reciente de WeChat/DingTalk", "generar un informe semanal", "buscar archivos de cierto grupo", y el MCP informe un error indicando "base de datos no encontrada" o devuelva resultados vacíos, el agente debe ejecutar la inicialización de forma autónoma:

Inicialización de la base de datos de DingTalk

DingTalk se descifra localmente fuera de línea con Python puro, casi 100% automatizado, sin necesidad de permisos de administrador:

# El agente ejecuta la inicialización
dingtalk-init
  • Salida esperada: detecta UID activo, muestra 🎉 ¡Sincronización de datos de DingTalk inicializada con éxito!.
  • Juicio previo del entorno (prohibido escanear a ciegas): si se indica que no se encuentra el directorio de datos o el UID, está prohibido que el agente realice una búsqueda recursiva profunda sin rumbo escaneando procesos o discos en la máquina anfitrión. Debe detenerse directamente e informar al usuario, preguntándole y recordándole que confirme si el cliente de DingTalk ya ha iniciado sesión en la máquina actual.

Inicialización de la base de datos de WeChat

WeChat necesita la clave y realizar el descifrado y la verificación en la base de datos WCDB:

  • Windows:
    # Windows: Ejecutar como administrador
    wechat-init
    
    WeChat necesita extraer la clave de la memoria del proceso del cliente en ejecución y realizar la verificación. El cliente de WeChat debe estar iniciado y haber iniciado sesión. Si WeChat no está iniciado, wechat-init mostrará un error.
  • macOS:
    # macOS: admite pasar directamente la frase de contraseña de 64 bits
    wechat-init --passphrase <frase de contraseña hexadecimal de 64 bits>
    
    La herramienta localiza automáticamente el directorio de datos de WeChat en macOS (~/Library/Containers/com.tencent.xinWeChat/Data/Documents/xwechat_files/*/db_storage), llama al CommonCrypto nativo del sistema (CCCrypt) para derivar la clave y completa el descifrado.
  • Verificación previa de la ejecución de WeChat (prohibido escanear a ciegas):
    • Restricción importante: si no se encuentra el proceso de WeChat o faltan los materiales de la clave, el agente no debe intentar adivinar ni escanear procesos no relacionados del sistema ni recorrer directorios globales del sistema.
    • Manejo correcto: debe explicar proactivamente al usuario el estado actual del entorno, guiándolo para preparar el entorno o ingresar la frase de contraseña.
  • Determinación de permisos: si Windows muestra un error Access Denied, explicar la razón al usuario y sugerir ejecutar como administrador.
  • Indicador de éxito: genera una base de datos descifrada en el directorio de datos del usuario ~/.wechat_mcp/decrypted/ y completa la limpieza del índice FTS5 en ~/.wechat_mcp/app.db. Si solo es necesario volver a ejecutar la limpieza de datos y el índice, se puede ejecutar wechat-init --etl-only.

2.2 Durante la ejecución de la tarea: Especificaciones de invocación de herramientas MCP

Después de una inicialización exitosa, el agente debe priorizar la búsqueda a través de herramientas MCP, evitando el uso directo de consultas SQL sin procesar:

Orden de invocación recomendado para WeChat:

  1. list_wechat_sessions(limit=20): primero enumera las sesiones/grupos activos recientes para obtener el session_id clave (como xxx@chatroom o el ID de WeChat).
  2. search_wechat_messages(query="palabra clave", limit=50): búsqueda de texto completo global del contenido del chat (admite paginación con offset).
  3. get_session_history(session_id="...", limit=100): obtiene el flujo de mensajes de contexto de la sesión objetivo.
  4. get_message_image(message_id=...): Descifrado de imágenes de chat bajo demanda. Cuando los mensajes de búsqueda o historial contengan [imagen], usar el id del mensaje correspondiente para invocar esta herramienta.
    • Modo predeterminado: devuelve la ruta física absoluta local de la imagen descifrada (almacenada en caché en ~/.wechat_mcp/images/), evitando que las imágenes grandes en Base64 exploten directamente el contexto del agente;
    • Modo de visualización de imágenes multimodales: si el agente actual necesita análisis visual de imágenes, se puede configurar include_base64=True para extraer la cadena Base64 para que el modelo la entienda.
  5. search_shared_files(keyword="...", limit=20): localiza las rutas de archivos transferidos en grupos o chats privados.

WeChat también proporciona: get_messages_by_date / get_messages_by_range (obtener datos por fecha o rango de tiempo), search_contacts (búsqueda inversa de contactos), list_chatroom_members (lista de miembros del grupo), search_media_files (rutas de disco de imágenes/videos), list_favorites (favoritos), list_emoticons (emojis), get_chat_activity_stats (estadísticas de actividad), get_persona_style (destilación del estilo de comunicación), get_sync_status (actualización del índice). get_messages_by_date / get_messages_by_range y search_wechat_messages también admiten paginación con offset.

Orden de invocación recomendado para DingTalk:

  1. list_dingtalk_conversations(limit=20): obtiene la lista de grupos y chats privados recientes (asignados automáticamente a los nombres reales y nombres de grupo más recientes).
  2. search_dingtalk_messages(keyword="palabra clave", limit=50): búsqueda de texto agregada en 128 subtablas.
  3. get_dingtalk_messages(cid="...", limit=100): ver los detalles de la conversación en un grupo o chat privado específico de DingTalk.
  4. list_dingtalk_contacts(keyword="nombre/pinyin"): búsqueda inversa rápida del UID del contacto y nombre real.

2.3 Actualización de versión y mantenimiento (Project Upgrade & Version Maintenance)

Cuando el usuario solicite "actualizar im-mcp", "actualizar el MCP de WeChat/DingTalk", "obtener la última corrección" o se descubra el lanzamiento de nuevas funciones/correcciones de errores, el agente debe realizar una actualización sin problemas según el método de instalación actual:

1. Actualización en modo de instalación persistente global (recomendado):

Si el usuario instaló previamente con uv tool install, usar uv tool update o reinstalar especificando el repositorio Git:

# Actualización global estándar con un solo clic
uv tool upgrade im-mcp

# O forzar la reinstalación con la última versión del repositorio remoto (admite el último HEAD de Git)
uv tool install --force "git+https://github.com/stkoecn/im-mcp.git" --with "im-mcp[all]"

# Entorno de red nacional (fuente Gitee)
uv tool install --force "git+https://gitee.com/ws4m/im-mcp.git" --with "im-mcp[all]"

2. Modo de ejecución ad hoc (uvx):

Si se ejecuta a través de uvx en un entorno limitado, uvx puede almacenar en caché una versión anterior de Wheel. Para actualizar o forzar la actualización de la caché de versiones:

# Limpiar la caché de herramientas temporales de uvx para asegurar que se obtenga el último código Git
uv cache clean im-mcp

# O agregar el parámetro --refresh en la próxima invocación de uvx para forzar la obtención de la última versión
uvx --refresh --from "git+https://github.com/stkoecn/im-mcp.git[all]" <comando>

3. Recarga sin problemas después de la actualización:

Una vez completada la actualización, el agente debe recordar proactivamente al usuario que refresque o recargue el cliente para cargar la última versión de la definición del servicio MCP y el conjunto de herramientas:

  • Pi / Pebrel: indicar que ingrese /reload;
  • Claude Desktop / Cursor / WorkBuddy: indicar que reinicie el cliente o reconecte el servidor MCP;
  • Si esta actualización implica un cambio en la lógica de limpieza de la base de datos subyacente, se puede ejecutar wechat-init --etl-only para reconstruir sin pérdidas el último índice FTS en 2 segundos, sin necesidad de volver a extraer o descifrar.

2.4 Después de completar la tarea: Limpieza de datos y privacidad (Post-flight Cleanup)

Después de completar el informe semanal, el resumen de horas de trabajo o cuando el usuario solicite explícitamente "limpiar el entorno", "eliminar los registros de chat exportados", el agente debe invocar proactivamente im-clean:

Vista previa de los archivos a limpiar (verificación de seguridad de solo lectura):

im-clean --dry-run

Ejecutar la limpieza por completo:

# Usar el parámetro -y para limpiar silenciosamente todos los SQLite de texto plano, claves y caché intermedia exportados (admite la detección automática y el manejo de bloqueos de procesos residentes)
im-clean -y

# Si se encuentra con un bloqueo de identificador residual, se puede agregar --force para forzar la terminación del servicio MCP y completar la eliminación
im-clean -y --force

Limpiar solo datos de una plataforma específica:

# Limpiar solo datos de WeChat, conservando DingTalk
im-clean --scope wechat -y

# Limpiar solo datos de DingTalk, conservando WeChat
im-clean --scope dingtalk -y

2.5 Desinstalación completa y limpieza coordinada del cliente (Full Uninstallation Guidance)

Cuando el usuario solicite explícitamente "desinstalar completamente este MCP", "eliminar por completo la herramienta de chat y su configuración", el agente debe ayudar al usuario a completar la limpieza estándar en el siguiente orden e informar proactivamente al usuario qué pasos debe realizar manualmente en la interfaz del cliente:

  1. Salir del cliente o detener el servicio: recordar al usuario que primero salga del cliente de IA actual, o dejar que im-clean -y --force maneje automáticamente los procesos MCP residuales;
  2. Limpiar datos automáticamente: el agente ejecuta im-clean -y --force para eliminar por completo ~/.wechat_mcp y ~/.dingtalk_mcp (asegurándose de que el código de retorno sea 0; si no es 0, está estrictamente prohibido informar un éxito falso);
  3. Desinstalar dependencias automáticamente: el agente ejecuta uv tool uninstall im-mcp o uv cache clean para limpiar el entorno y la caché;
  4. Proporcionar proactivamente al usuario un recordatorio de limpieza manual del cliente:
    • El agente debe, según el cliente anfitrión actual, indicar al usuario que limpie manualmente los archivos de configuración (las rutas comunes específicas de cada entorno se pueden encontrar en el [Apéndice: Directorios de referencia de entornos anfitriones de agentes principales] al final de esta habilidad).

3. Manejo de fallos comunes y reglas de comportamiento del agente (Troubleshooting & Agent Rules)

  1. Regla fundamental: detenerse inmediatamente ante un error, está estrictamente prohibido analizar el código o hacer cambios a ciegas:

    • Si durante la instalación, inicialización o invocación de prueba se encuentra con algún error desconocido, conflicto de entorno o anomalía de ejecución:
    • Absolutamente prohibido: el agente tiene estrictamente prohibido hurgar en el código fuente, escribir parches para corregir el código, adivinar y reintentar repetidamente, o solucionar problemas del sistema a ciegas;
    • Debe hacer: detenerse inmediatamente en el paso del error, mostrar el resumen del error central tal cual y preguntar explícitamente al usuario:

      "Se encontró un error en el paso actual: [breve descripción del error]. ¿Desea solucionar el problema usted mismo o detener la operación y no usarlo más?"

    • Entregar el control al usuario, y actuar solo después de que el usuario confirme continuar o salir.
  2. Después de la instalación e inicialización, entregar inmediatamente al usuario, está estrictamente prohibido escribir código para simular el protocolo y realizar pruebas repetidas:

    • Una vez que el agente completa la instalación de la herramienta (como uv tool install), la escritura del archivo de configuración y la inicialización con init, todo el proceso de despliegue ha finalizado.
    • Absolutamente prohibido: el agente escriba scripts de prueba en Python/Node para simular el handshake JSON-RPC 2.0, la comunicación por tuberías o sondear los detalles internos del protocolo. Esto no solo aumenta el consumo de Tokens y el riesgo de errores inesperados e incontrolables, sino que también priva al usuario de la percepción y el control en tiempo real.
    • Debe hacer: después de completar la instalación y la inicialización, entregar directamente y proporcionar la guía de uso más concisa y amigable:
      1. Indicar explícitamente al usuario que habilite/confíe en este MCP en el cliente actual (por ejemplo, indicar al usuario de Pi que ejecute /reload, y al usuario de Claude Desktop / Cursor que reinicie el cliente para que surta efecto);
      2. Proporcionar 1 o 2 ejemplos simples e intuitivos en lenguaje natural para guiar la experiencia del usuario, por ejemplo:

        "¡La instalación e inicialización están listas! Confirme que ha habilitado/confiado en este MCP en el cliente (por ejemplo, ejecute /reload), y luego simplemente dígame algo como esto para comenzar a usarlo: 👉 'Ayúdame a ver de qué se ha estado hablando en el grupo del proyecto recientemente' 👉 'Busca los resultados de los informes estadísticos que Cheng Peng ha enviado en DingTalk' 👉 'Resume los registros de comunicación de la semana pasada sobre tal requisito para hacer un informe semanal'"

  3. Autorización y confianza de la aplicación del cliente (identificación autónoma del entorno anfitrión y guía de habilitación):

    • El agente debe identificar de forma autónoma, a través de las características de la sesión actual, el cliente anfitrión que está utilizando el usuario;
    • Está estrictamente prohibido generar de forma vaga "habilítelo en su cliente", sino que debe proporcionar la forma específica de activación para el cliente anfitrión correspondiente según el anfitrión actual (por ejemplo, indicar al usuario de Pi que ingrese /reload, o indicar al usuario de la aplicación de escritorio que reinicie para que surta efecto; las características específicas se pueden encontrar en el apéndice al final).
  4. Prohibiciones de comportamiento cuando no se encuentra el proceso de WeChat/DingTalk:

    • Está estrictamente prohibido realizar un escaneo violento y completo del disco que consuma mucho tiempo y sea intrusivo en la máquina anfitrión, o adivinar otros procesos del sistema;
    • Debe detenerse directamente y confirmar amablemente con el usuario el estado de inicio de sesión del cliente.
  5. Problema de sincronización de mensajes incrementales de WeChat: Cuando el cliente de WeChat está en línea, los nuevos mensajes se escribirán en la base de datos cifrada original. Para obtener los mensajes nuevos que acaban de generarse, el agente puede indicar al usuario que "vuelva a ejecutar wechat-init" para actualizar la base de datos local descifrada.

  6. Problema de bloqueo WAL de DingTalk: dingtalk-init ya tiene un mecanismo de copia automática incorporado, por lo que incluso si DingTalk se está ejecutando y está en una transacción WAL, no se producirá un conflicto de bloqueo de base de datos de SQLite.

  7. Principio de privacidad y seguridad: La base de datos SQLite descifrada es información de privacidad local sensible. En máquinas públicas o entornos multiinquilino, después de completar el trabajo, asegúrese de guiar o ejecutar automáticamente im-clean -y.

  8. Informe de comentarios de despliegue y mecanismo de desarrollo automático de la comunidad (Deployment Feedback & Auto-Development):

    • Tanto si el despliegue y la inicialización son exitosos como si encuentran un fallo, al final del proceso, el agente debe organizar y generar de forma proactiva un informe de comentarios de despliegue y operación estructurado y conciso para el usuario, e indicarle que puede copiarlo y enviarlo a GitHub como Issue.
    • ⚠️ Principio de resalte central (debe marcarse de manera prominente, estrictamente prohibido ser vago):
      • En el título del informe y en la primera línea de la barra de estado, se debe utilizar un identificador visual extremadamente llamativo (como 【Estado: 🟢 Despliegue exitoso / SUCCESS】 o 【Estado: 🔴 Despliegue bloqueado / FAILED】);
      • Rechazar firmemente narrativas ambiguas o neutrales, para que el usuario y el agente de resolución de problemas puedan ver de un vistazo si fue un éxito o un fracaso.
    • Compromiso de operación y mantenimiento automatizados del agente: indicar al usuario: "Este proyecto se ha integrado con el pipeline de colaboración automatizada del Agente de GitHub. Los Issues que envíe serán reproducidos, investigados, corregidos y fusionados automáticamente por un agente dedicado."
    • Plantilla estándar de generación de informes:
      • Si es exitoso (SUCCESS):
        ### 📋 Informe de comentarios de despliegue de im-mcp 【Estado: 🟢 Despliegue exitoso / SUCCESS】
        > **Conclusión final**: ✅ Todas las dependencias se instalaron correctamente, la extracción de datos y la sincronización de índices se completaron, ¡el servicio tiene capacidad de invocación inmediata!
        
        - **Estado central**: 🟢 SUCCESS
        - **Información del entorno**: Versión del SO (ej. Win11 23H2), cliente anfitrión (ej. WorkBuddy / Pi / Claude Desktop), versiones de Python y uv
        - **Modo de instalación**: `uv tool install` / `uvx` / código fuente local
        - **Métricas de inicialización**: tiempo (ej. WeChat 12s / DingTalk 3s), número de contactos/sesiones/mensajes sincronizados
        - **Sugerencias de uso**: experiencia de inicio en frío, guía de sincronización incremental o expectativas de próximas funciones
        - **Enlace de comentarios**: puede enviar su experiencia en [GitHub Issues](https://github.com/stkoecn/im-mcp/issues), ¡el Agente de la comunidad realizará un seguimiento y optimización automáticos!
        
      • Si falla o encuentra obstáculos (FAILED):
        ### ⚠️ Informe de comentarios de despliegue de im-mcp 【Estado: 🔴 Despliegue bloqueado / FAILED】
        > **Conclusión final**: ❌ El proceso se interrumpió a medio camino, el servicio central no puede iniciarse normalmente. Consulte la siguiente localización de fallos.
        
        - **Estado central**: 🔴 FAILED
        - **Fase de bloqueo**: Instalación de dependencias / Extracción de clave de WeChat / Descifrado de DingTalk / Construcción de índice de base de datos / Montaje del cliente
        - **Características del entorno**: Versión del SO, cliente anfitrión, versión de WeChat (ej. 4.x / 3.x), versión de DingTalk (ej. 7.x V3)
        - **Resumen del error clave**: capturar el stack trace central del error o el mensaje del sistema (ej. Access Denied / Proceso no en ejecución / Bloqueo de archivo denegado)
        - **Medidas intentadas**: si se elevaron privilegios, si se intentó `--force` o `--etl-only`
        - **Sugerencias de mejora**: señalar los enlaces del proceso actual que no son fluidos o que necesitan tolerancia automática a fallos de la herramienta
        - **Comentarios con un solo clic**: copie directamente este informe y envíelo a [GitHub Issues](https://github.com/stkoecn/im-mcp/issues), ¡el agente dedicado del repositorio analizará automáticamente los registros y realizará la reparación!
        

4. Apéndice: Directorios de referencia de entornos anfitriones de agentes principales (solo como referencia)

💡 Declaración: Este directorio recopila el comportamiento predeterminado y las características de configuración de los principales entornos de cliente/agente de IA actuales, solo como referencia. Cada plataforma puede tener ajustes después de las actualizaciones de versión, consulte la documentación oficial más reciente de la plataforma correspondiente.

Entorno de clienteCaracterísticas de identificación típicasReferencia de método de configuración / habilitaciónReferencia de método de desinstalación y limpieza
Pi / PebrelVariables de entorno PI_* o directorio ~/.pi/Editar ~/.pi/agent/mcp.json, ingresar /reload en la sesión para recargar y aplicarEliminar la entrada de mcp.json, eliminar ~/.agents/skills/im-mcp, ingresar /reload
Claude DesktopAppData local con configuración de ClaudeEditar %APPDATA%\Claude\claude_desktop_config.json, reiniciar completamente la aplicación del clienteEliminar la entrada de mcpServers en el archivo de configuración y reiniciar el software, limpiar el directorio de la skill
CursorDerivado de VS Code, existe configuración de CursorAgregar en Settings ➔ Features ➔ MCP Servers, montaje instantáneo en la interfazHacer clic en Delete / Remove en la entrada correspondiente de la lista de servidores MCP
Cline / Roo CodePanel de extensiones de VS CodeAgregar configuración en la pestaña MCP de la barra lateral de extensiones, cambiar a "Enabled" para activar y autorizarApagar el interruptor o hacer clic en el icono de la papelera para eliminar en la lista MCP de la barra lateral
Cherry StudioHerramienta de gestión de múltiples modelos de escritorioAgregar comando stdio en Configuración ➔ Servidores MCP, guardar para aplicarSeleccionar y hacer clic en "Eliminar" en la lista de servidores MCP, guardar la configuración
WorkBuddyDirectorio ~/.workbuddy/ o configuración relacionadaEditar ~/.workbuddy/mcp.json, hacer clic manualmente en "Confiar/Habilitar" en la interfaz de gestión de conectoresEliminar el bloque de configuración de mcp.json y eliminar el conector en la interfaz

Skills relacionados