🚀 钉钉 MCP 服务器

钉钉的 Model Context Protocol (MCP) 服务器实现，让 Claude 可以与钉钉工作空间进行交互，为工作沟通和协作带来便利。

✨ 主要特性

提供了一系列实用工具，方便与钉钉用户进行交互和信息获取。

📦 安装指南

工具介绍

1. dingtalk_search_users

   • 功能：搜索钉钉用户。
   • 必填参数：
     • query (字符串)：搜索关键词。
   • 可选参数：
     • exact_match (布尔值，默认: false)：是否进行精确匹配。
   • 返回：匹配的用户列表及其基本信息。

2. dingtalk_get_user_info

   • 功能：获取用户详细信息。
   • 必填参数：
     • user_id (字符串)：用户 ID。
   • 返回：用户的详细信息，包括姓名、工号、部门、入职时间、联系方式（手机、邮箱等）。

3. dingtalk_send_message

   • 功能：向钉钉用户发送私信。
   • 必填参数：
     • user (字符串)：接收消息的用户名称。
     • content (字符串)：消息内容。
   • 返回：消息发送确认。

设置步骤

1. 创建钉钉应用：

   • 访问钉钉开发者后台。
   • 点击“创建应用”。
   • 选择“企业内部应用”。
   • 填写应用信息并创建。

2. 配置应用权限： 在应用详情页面配置以下权限：

   • userinfo：获取用户信息。
   • message：发送消息。
   • user：获取用户列表。

3. 获取应用凭证：

   • 保存应用的 AppKey 和 AppSecret。

💻 使用示例

与 Claude Desktop 配合使用

在 claude_desktop_config.json 中添加以下配置：

npx 方式

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

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"
      }
    }
  }
}