Dingtalk V2

🚀 釘釘 MCP 服務器 V2

這是一個基於 MCP（模型控制協議）的釘釘機器人服務器實現。它提供了與釘釘交互的各種功能，包括髮送消息、獲取會話信息、用戶信息和日曆事件等，為開發者提供了便捷的釘釘機器人開發解決方案。

🚀 快速開始

環境要求

• Python 3.10+
• MCP 0.1.0+
• aiohttp 3.9.1+

環境變量配置

使用前需設置以下環境變量：

• DINGTALK_APP_KEY：釘釘應用的 AppKey
• DINGTALK_APP_SECRET：釘釘應用的 AppSecret

在 Claude 客戶端中使用

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

{
  "mcpServers": {
    "dingding": {
      "command": "sh",
      "args": [
        "-c",
        "docker ps -a | grep mcp-dingding-v2 | awk '{print $1}' | xargs -r docker rm -f > /dev/null 2>&1; docker pull ghcr.io/wllcnm/mcp-dingding-v2:latest > /dev/null 2>&1; docker run -i --rm --name mcp-dingding-v2 -e DINGTALK_APP_KEY=你的AppKey -e DINGTALK_APP_SECRET=你的AppSecret ghcr.io/wllcnm/mcp-dingding-v2:latest"
      ]
    }
  }
}

本地開發

1. 克隆代碼庫：

git clone https://github.com/yourusername/dingtalk-mcp-server.git
cd dingtalk-mcp-server

2. 安裝依賴：

pip install -r requirements.txt

3. 配置環境變量並運行：

export DINGTALK_APP_KEY=你的AppKey
export DINGTALK_APP_SECRET=你的AppSecret
python server.py

✨ 主要特性

• 發送消息到釘釘會話
• 獲取釘釘會話信息
• 獲取釘釘用戶信息
• 查詢用戶日曆事件
• 支持多種消息類型（文本、Markdown、鏈接等）

💻 使用示例

基礎用法

在 Claude 中，可以這樣使用工具：

{
  "tool": "send_message",
  "arguments": {
    "conversation_id": "你的會話ID",
    "message": "Hello, DingTalk!",
    "msg_type": "text"
  }
}

高級用法

查詢日曆示例：

{
  "tool": "get_calendar_list",
  "arguments": {
    "userid": "用戶ID",
    "start_time": 1704067200000,  // 2024-01-01 00:00:00
    "end_time": 1704153600000,    // 2024-01-02 00:00:00
    "max_results": 10
  }
}

📚 詳細文檔

API 工具

send_message

• 功能：發送消息到指定會話。
• 參數：
  • conversation_id：目標會話 ID。
  • message：要發送的消息內容。
  • msg_type：消息類型，默認為 "text"。

get_calendar_list

• 功能：獲取指定用戶的時間表。
• 參數：
  • userid：用戶 ID。
  • start_time：開始時間（Unix 時間戳）。
  • end_time：結束時間（Unix 時間戳）。
  • max_results：最大返回結果數，默認為 10。

⚠️ 注意事項

安全性

• 請妥善保管釘釘 API 憑證。
• 不要在公共場合分享配置文件。
• 建議使用環境變量而非硬編碼憑證。

故障排除

• 檢查 API 憑證是否正確。
• 確保網絡連接正常。
• 查看日誌獲取詳細錯誤信息。

📄 許可證

MIT