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