钉钉 MCP 服务器

钉钉的模型上下文协议（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桌面使用

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

环境变量

1. DINGTALK_APP_KEY：必需。钉钉应用的AppKey
2. DINGTALK_APP_SECRET：必需。钉钉应用的AppSecret

故障排除

如果遇到权限错误，请检查：

1. 应用是否已正确配置所需的权限
2. 应用是否已正确安装在企业中
3. 应用凭证是否配置正确
4. 应用是否已获得必要的访问权限

构建

Docker构建：

docker build -t mcp/dingtalk -f Dockerfile .

许可证

本项目采用MIT许可证。这意味着您可以自由地使用、修改和分发该软件，但必须遵守MIT许可证中的条款和条件。更多细节，请参阅项目仓库中的LICENSE文件。 </中文翻译>