Dingtalk MCP Server

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