dingtalk-agent-client

MCP.Pizza Chef: darrenyao

The dingtalk-agent-client transforms the DingTalk client into an MCP Host client, enabling seamless interaction with enterprise AI assistants through MCP Server calls. It supports OAuth2 user authentication, token management, user search and info retrieval, and rich messaging capabilities including text, Markdown, and user mentions. It integrates multiple MCP tools like user queries, message sending, weather, and order info extraction, facilitating robust AI-enhanced workflows within DingTalk environments.

Unmaintained · No commits in 15 months.

Use This MCP client To

Authenticate users via OAuth2 for secure AI interactions Search and retrieve detailed user information in DingTalk Send text and Markdown messages with user mentions Integrate AI assistants with DingTalk for enterprise workflows Manage user and enterprise application access tokens Query weather and order information through MCP tools Enable multi-tool AI workflows inside DingTalk client

README

DingTalk Agent Client

把钉钉客户端作为 MCP Host 客户端,与创建的企业AI 助理对话,实现 MCP Server 调用

产品使用示例

产品使用示例

功能特性

  • 用户认证

    • 支持 OAuth2 授权
    • 支持用户访问令牌和刷新令牌管理
    • 支持企业应用访问令牌管理
  • 用户管理

    • 支持用户搜索(精确/模糊匹配)
    • 支持获取用户详细信息
    • 支持获取当前用户信息
  • 消息能力

    • 支持文本消息发送
    • 支持 Markdown 消息发送
    • 支持 @ 用户和 @ 所有人
  • MCP 工具集成

    • 用户查询工具
    • 消息发送工具
    • 天气查询工具
    • 订单信息提取工具
    • 其他实用工具

安装

方式一:直接安装

  1. 克隆项目
git clone https://github.com/darrenyao/dingtalk-agent-client.git
cd dingtalk-agent-client
  1. 安装依赖
pip install -r requirements.txt
  1. 配置环境变量
cp .env.example .env
# 编辑 .env 文件,填入你的钉钉应用配置

方式二:Docker 部署

  1. 克隆项目
git clone https://github.com/darrenyao/dingtalk-agent-client.git
cd dingtalk-agent-client
  1. 配置环境变量

dingtalk-agent-client FAQ

How do I install the dingtalk-agent-client?
You can install it by cloning the GitHub repo, installing dependencies via pip, configuring environment variables, or deploying with Docker using docker-compose.
What authentication methods does dingtalk-agent-client support?
It supports OAuth2 authorization, user access token and refresh token management, and enterprise application access token management.
Can I send different types of messages using this client?
Yes, it supports sending plain text messages, Markdown formatted messages, and mentions to specific users or all users.
How does dingtalk-agent-client integrate with MCP tools?
It includes built-in MCP tools like user query, message sending, weather query, and order information extraction to extend AI assistant capabilities.
Is it possible to manage user information with this client?
Yes, it supports precise and fuzzy user searches, fetching detailed user info, and retrieving current user data.
Can I deploy dingtalk-agent-client in a containerized environment?
Yes, it supports Docker deployment with docker-compose for easy containerized setup and management.
What environment configuration is required?
You need to configure your DingTalk application credentials in the .env file as per the provided example.
Does this client support refreshing tokens automatically?
Yes, it manages user access tokens and refresh tokens to maintain authenticated sessions.