DingTalk

Un servidor para interactuar con espacios de trabajo de DingTalk utilizando el Protocolo de Contexto del Modelo.

GitHub
5
Prueba este MCPPatrocinado

Documentación

Servidor MCP de DingTalk

Implementación del servidor Model Context Protocol (MCP) de DingTalk, que permite a Claude interactuar con espacios de trabajo de DingTalk.

image

Herramientas

  1. dingtalk_search_users

    • Buscar usuarios de DingTalk
    • Parámetros obligatorios:
      • query (string): Palabra clave de búsqueda
    • Parámetros opcionales:
      • exact_match (boolean, predeterminado: false): Si se debe realizar una coincidencia exacta
    • Devuelve: Lista de usuarios coincidentes y su información básica

  2. dingtalk_get_user_info

    • Obtener información detallada del usuario
    • Parámetros obligatorios:
      • user_id (string): ID de usuario
    • Devuelve: Información detallada del usuario, que incluye:
      • Nombre
      • Número de empleado
      • Departamento
      • Fecha de incorporación
      • Información de contacto (teléfono móvil, correo electrónico, etc.)

  3. dingtalk_send_message

    • Enviar mensaje privado a un usuario de DingTalk
    • Parámetros obligatorios:
      • user (string): Nombre del usuario que recibe el mensaje
      • content (string): Contenido del mensaje
    • Devuelve: Confirmación de envío del mensaje

Configuración

  1. Crear una aplicación de DingTalk:

  2. Configurar los permisos de la aplicación: En la página de detalles de la aplicación, configure los siguientes permisos:

    • userinfo: Obtener información del usuario
    • message: Enviar mensajes
    • user: Obtener lista de usuarios

  3. Obtener las credenciales de la aplicación:

    • Guarde el AppKey y AppSecret de la aplicación

Uso con Claude Desktop

Agregue la siguiente configuración en claude_desktop_config.json:

Método npx

{
  "mcpServers": {
    "dingtalk": {
      "command": "npx",
      "args": [
        "-y",
        "@darrenyao/server-dingtalk"
      ],
      "env": {
        "DINGTALK_APP_KEY": "your_app_key",
        "DINGTALK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Método docker

{
  "mcpServers": {
    "dingtalk": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DINGTALK_APP_KEY",
        "-e",
        "DINGTALK_APP_SECRET",
        "mcp/dingtalk"
      ],
      "env": {
        "DINGTALK_APP_KEY": "your_app_key",
        "DINGTALK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Variables de entorno

  1. DINGTALK_APP_KEY: Obligatorio. AppKey de la aplicación de DingTalk
  2. DINGTALK_APP_SECRET: Obligatorio. AppSecret de la aplicación de DingTalk

Solución de problemas

Si encuentra errores de permisos, verifique:

  1. Si la aplicación tiene configurados correctamente los permisos necesarios
  2. Si la aplicación está instalada correctamente en la empresa
  3. Si las credenciales de la aplicación están configuradas correctamente
  4. Si la aplicación ha obtenido los permisos de acceso necesarios

Compilación

Compilación con Docker:

docker build -t mcp/dingtalk -f Dockerfile .

Licencia

Este proyecto utiliza la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, pero debe cumplir con los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.