Dingtalk

🚀 釘釘 MCP 服務

這是一個基於 MCP（模型控制協議）的釘釘服務，它為用戶提供了訪問釘釘 API 的功能，能幫助開發者更便捷地與釘釘系統進行交互。

🚀 快速開始

在使用該服務前，你需要了解其環境要求、安裝配置步驟以及不同場景下的使用方法。

✨ 主要特性

• 獲取釘釘 Access Token
• 獲取部門列表
• 獲取部門用戶列表
• 根據姓名查詢用戶詳細信息（包括遍歷部門查找用戶）

📦 安裝指南

環境要求

• Python 3.12+
• Docker（推薦）
• 釘釘應用憑證

安裝步驟

1. 獲取釘釘應用憑證

1. 登錄釘釘開放平臺。
2. 創建企業內部應用。
3. 獲取應用的 AppKey 和 AppSecret。

2. 配置環境變量

需要設置以下環境變量：

DINGDING_APP_KEY=你的AppKey
DINGDING_APP_SECRET=你的AppSecret

💻 使用示例

在 Claude 桌面客戶端中使用

在你的 claude_desktop_config.json 中添加以下配置：

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

本地開發

1. 克隆倉庫：

git clone <repository_url>
cd dingding_chat

2. 安裝依賴：

pip install -r requirements.txt

3. 運行服務：

python src/server.py

Docker 部署

1. 拉取鏡像：

docker pull ghcr.io/你的用戶名/dingding-mcp:latest

2. 運行容器：

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

📚 詳細文檔

API 說明

1. 獲取 Access Token

• 功能：獲取釘釘 API 的 access token
• 工具名：get_access_token
• 參數：無
• 返回：access token 字符串

2. 獲取部門列表

• 功能：獲取企業的部門列表
• 工具名：get_department_list
• 參數：
  • fetch_child: 是否抓取子部門列表（可選，默認為 true）
• 返回：部門列表信息（包括部門 ID、名稱、父部門 ID 等）

3. 獲取部門用戶列表

• 功能：獲取指定部門的用戶列表
• 工具名：get_department_users
• 參數：
  • department_id: 部門 ID（必填）
• 返回：部門用戶列表（包括用戶 ID、姓名等）

4. 根據姓名查詢用戶

• 功能：通過用戶姓名查詢用戶詳細信息
• 工具名：get_user_by_name
• 參數：
  • user_name: 用戶姓名
• 返回：用戶詳細信息（包括用戶 ID、姓名、郵箱等）

⚠️ 注意事項

⚠️ 重要提示

配置釘釘應用憑證時，請確保 AppKey 和 AppSecret 正確無誤。使用本服務進行用戶查詢時，可能會涉及網絡延遲，具體取決於釘釘服務器響應時間。

💡 使用建議

建議在生產環境中使用 Docker 部署以保證服務穩定性。

📄 許可證

本項目遵循 MIT 協議。