钉钉 MCP 服务

基本能力

产品定位

钉钉 MCP 服务是一个用于企业内部应用开发的钉钉API访问服务，主要用于与钉钉平台进行交互，获取组织结构和用户信息。

核心功能

1. 获取钉钉 Access Token
2. 获取部门列表
3. 获取部门用户列表
4. 根据姓名查询用户详细信息（包括遍历部门查找用户）

适用场景

1. 企业内部管理系统开发
2. 钉钉组织架构同步
3. 用户信息查询系统
4. 基于钉钉API的自动化流程

工具列表

1. get_access_token - 获取钉钉API的access token
2. get_department_list - 获取企业的部门列表
3. get_department_users - 获取指定部门的用户列表
4. search_user_by_name - 通过用户姓名查询用户详细信息

常见问题解答

1. 确保正确配置钉钉应用的凭证信息
2. 由于钉钉API的限制，查询用户信息需要遍历所有部门，可能需要一定时间
3. 建议在生产环境中使用 Docker 部署，以确保环境一致性

使用教程

使用依赖

• Python 3.12+
• Docker（推荐）
• 钉钉应用凭证

安装教程

1. 获取钉钉应用凭证

1. 登录钉钉开放平台
2. 创建企业内部应用
3. 获取应用的 AppKey 和 AppSecret

2. 配置环境变量

DINGDING_APP_KEY=你的AppKey
DINGDING_APP_SECRET=你的AppSecret

3. 安装方式

在 Claude 桌面客户端中使用

{
  "mcpServers": {
    "dingding": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "DINGDING_APP_KEY=你的AppKey",
        "-e", "DINGDING_APP_SECRET=你的AppSecret",
        "ghcr.io/你的用户名/dingding-mcp:latest"
      ]
    }
  }
}

本地开发

git clone <repository_url>
cd dingding_chat
pip install -r requirements.txt
python src/server.py

Docker 部署

docker pull ghcr.io/你的用户名/dingding-mcp:latest
docker run -d --name dingding-mcp \
  -e DINGDING_APP_KEY=你的AppKey \
  -e DINGDING_APP_SECRET=你的AppSecret \
  ghcr.io/你的用户名/dingding-mcp:latest

调试方式

1. 检查环境变量是否正确设置
2. 验证钉钉应用凭证是否正确
3. 运行服务后，尝试调用API工具验证功能是否正常

许可证

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