Dingtalk

🚀 钉钉 MCP サービス

これは MCP（モデル制御プロトコル）に基づく钉钉サービスで、钉钉 API へのアクセス機能を提供します。

✨ 主な機能

1. 钉钉の Access Token を取得する
2. 部門リストを取得する
3. 部門のユーザーリストを取得する
4. 名前に基づいてユーザーの詳細情報を検索する（部門を遍歴してユーザーを検索することも含む）

📦 インストール

環境要件

• Python 3.12 以上
• Docker（推奨）
• 钉钉アプリの認証情報

1. 钉钉アプリの認証情報を取得する

1. 钉钉開発者プラットフォームにログインする
2. 企業内アプリを作成する
3. アプリの AppKey と AppSecret を取得する

2. 環境変数を設定する

以下の環境変数を設定する必要があります。

DINGDING_APP_KEY=あなたのAppKey
DINGDING_APP_SECRET=あなたのAppSecret

💻 使用例

Claude デスクトップクライアントでの使用

1. あなたの 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

📚 ドキュメント

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、名前、メールアドレスなどを含む）

⚠️ 注意事項

1. 钉钉アプリの認証情報を設定する際には、AppKey と AppSecret が正しいことを確認してください。
2. このサービスを使用してユーザーを検索する際には、ネットワーク遅延が発生する可能性があり、具体的な遅延時間は钉钉サーバーの応答時間に依存します。
3. 本番環境では、サービスの安定性を確保するために Docker を使用してデプロイすることをお勧めします。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。