dingtalk-mcp-server
If you are the rightful owner of dingtalk-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
钉钉的 Model Context Protocol (MCP) 服务器实现,使 Claude 能够与钉钉工作空间进行交互。
钉钉 MCP 服务器
钉钉的 Model Context Protocol (MCP) 服务器实现,使 Claude 能够与钉钉工作空间进行交互。
工具
-
dingtalk_search_users
- 搜索钉钉用户
- 必需参数:
query
(string): 搜索关键词
- 可选参数:
exact_match
(boolean, 默认: false): 是否进行精确匹配
- 返回:匹配的用户列表及其基本信息
-
dingtalk_get_user_info
- 获取用户详细信息
- 必需参数:
user_id
(string): 用户 ID
- 返回:用户的详细信息,包括:
- 姓名
- 工号
- 部门
- 入职时间
- 联系方式(手机、邮箱等)
-
dingtalk_send_message
- 向钉钉用户发送私信
- 必需参数:
user
(string): 接收消息的用户名称content
(string): 消息内容
- 返回:消息发送确认
设置
-
创建钉钉应用:
- 访问钉钉开发者后台
- 点击"创建应用"
- 选择"企业内部应用"
- 填写应用信息并创建
-
配置应用权限: 在应用详情页面配置以下权限:
userinfo
: 获取用户信息message
: 发送消息user
: 获取用户列表
-
获取应用凭证:
- 保存应用的 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"
}
}
}
}
环境变量
DINGTALK_APP_KEY
: 必需。钉钉应用的 AppKeyDINGTALK_APP_SECRET
: 必需。钉钉应用的 AppSecret
故障排除
如果遇到权限错误,请检查:
- 应用是否已正确配置所需权限
- 应用是否已正确安装到企业
- 应用凭证是否正确配置
- 应用是否已获得必要的访问权限
构建
Docker 构建:
docker build -t mcp/dingtalk -f Dockerfile .
许可证
本项目采用 MIT 许可证。这意味着您可以自由使用、修改和分发软件,但需遵守 MIT 许可证的条款和条件。更多详情请参阅项目仓库中的 LICENSE 文件。