钉钉 MCP 服务器

钉钉 MCP 服务器

site icon
2025.04.21 1
JavaScript钉钉集成企业内部通讯交流协作
钉钉 MCP 服务器是一个实现 Model Context Protocol (MCP) 的服务,使 Claude 能够与钉钉工作空间进行交互。它提供了搜索钉钉用户、获取用户详细信息以及向钉钉用户发送私信等功能,适用于需要与钉钉工作空间集成的场景。
View on GitHub

Overview

基本能力

产品定位

钉钉 MCP 服务器是一个实现 Model Context Protocol (MCP) 的服务,使 Claude 能够与钉钉工作空间进行交互。

核心功能

  1. 搜索钉钉用户 (dingtalk_search_users)
  2. 支持关键词搜索用户
  3. 可选精确匹配
  4. 返回匹配的用户列表及其基本信息

  5. 获取用户详细信息 (dingtalk_get_user_info)

  6. 根据用户 ID 获取详细信息
  7. 包括姓名、工号、部门、入职时间、联系方式等

  8. 发送私信 (dingtalk_send_message)

  9. 向指定用户发送消息
  10. 返回消息发送确认

适用场景

  • 需要与钉钉工作空间集成的应用
  • 自动化办公流程
  • 企业内部通讯工具集成

工具列表

  1. dingtalk_search_users: 搜索钉钉用户
  2. dingtalk_get_user_info: 获取用户详细信息
  3. dingtalk_send_message: 向钉钉用户发送私信

常见问题解答

  • 权限错误: 检查应用是否已正确配置所需权限、是否已正确安装到企业、应用凭证是否正确配置、是否已获得必要的访问权限

使用教程

使用依赖

  1. 创建钉钉应用
  2. 访问钉钉开发者后台
  3. 点击"创建应用"
  4. 选择"企业内部应用"
  5. 填写应用信息并创建

  6. 配置应用权限

  7. userinfo: 获取用户信息
  8. message: 发送消息
  9. user: 获取用户列表

  10. 获取应用凭证

  11. 保存应用的 AppKey 和 AppSecret

安装教程

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

调试方式

  1. 确保环境变量 DINGTALK_APP_KEYDINGTALK_APP_SECRET 已正确设置
  2. 检查应用权限配置
  3. 验证应用是否已安装到企业
  4. 确认应用凭证是否正确

构建

Docker 构建:

docker build -t mcp/dingtalk -f Dockerfile .

许可证

该项目遵循 None 开源许可条款。