Dingtalk V2

🚀 钉钉 MCP サーバー V2

このプロジェクトは、MCP（モデル制御プロトコル）に基づく钉钉ロボットサーバーの実装です。钉钉とのやり取りに必要な様々な機能を提供し、メッセージの送信、会話情報やユーザー情報の取得、カレンダーイベントの取得などが可能です。

✨ 主な機能

• 钉钉会話へのメッセージ送信
• 钉钉会話情報の取得
• 钉钉ユーザー情報の取得
• ユーザーのカレンダーイベントの照会
• 複数のメッセージタイプ（テキスト、Markdown、リンクなど）のサポート

📦 インストール

環境要件

• 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

📚 ドキュメント

API ツール

send_message

• 機能: 指定された会話にメッセージを送信します。
• パラメータ:
  • conversation_id: 対象の会話 ID。
  • message: 送信するメッセージ内容。
  • msg_type: メッセージタイプ。デフォルトは "text"。

get_calendar_list

• 機能: 指定されたユーザーのカレンダーを取得します。
• パラメータ:
  • userid: ユーザー ID。
  • start_time: 開始時間（Unix タイムスタンプ）。
  • end_time: 終了時間（Unix タイムスタンプ）。
  • max_results: 最大返却件数。デフォルトは 10。

💻 使用例

基本的な使用法

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 の認証情報は適切に保管してください。
• 設定ファイルを公共の場所で共有しないでください。
• 認証情報をハードコードするのではなく、環境変数を使用することをおすすめします。

💡 使用建议

• API 認証情報が正しいことを確認してください。
• ネットワーク接続が正常であることを確認してください。
• 詳細なエラー情報を取得するには、ログを確認してください。

📄 ライセンス

MIT