把钉钉客户端作为 MCP Host 客户端，与创建的企业AI 助理对话，实现 MCP Server 调用
-
用户认证
- 支持 OAuth2 授权
- 支持用户访问令牌和刷新令牌管理
- 支持企业应用访问令牌管理
-
用户管理
- 支持用户搜索（精确/模糊匹配）
- 支持获取用户详细信息
- 支持获取当前用户信息
-
消息能力
- 支持文本消息发送
- 支持 Markdown 消息发送
- 支持 @ 用户和 @ 所有人
-
MCP 工具集成
- 用户查询工具
- 消息发送工具
- 天气查询工具
- 订单信息提取工具
- 其他实用工具
- 克隆项目
git clone https://github.com/darrenyao/dingtalk-agent-client.git
cd dingtalk-agent-client- 安装依赖
pip install -r requirements.txt- 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填入你的钉钉应用配置- 克隆项目
git clone https://github.com/darrenyao/dingtalk-agent-client.git
cd dingtalk-agent-client- 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填入你的钉钉应用配置- 构建并启动容器
# 构建镜像
docker-compose build
# 启动服务
docker-compose up -d
# 查看日志
docker-compose logs -f- 停止服务
docker-compose down-
创建 AI 助理并开通直通模式，文档参考：AI 助理直通模式 & 技能开发
-
开启 StreamMode
钉钉开放平台应用创建（调用mcp server 中注册的钉钉开放接口)
- 创建企业自建应用获取授权的 ClientId, ClientSecret
在 .env 文件中配置以下信息：
# 钉钉应用配置
# ai助理对应的 ak sk
DINGTALK_APP_KEY=your_app_key
DINGTALK_APP_SECRET=your_app_secret
# 开放平台应用接口调用使用的 CLIENT_ID，CLIENT_SECRET
DINGTALK_CORP_ID="YOUR_CORP_ID"
DINGTALK_CLIENT_ID="YOUR_CLIENT_ID"
DINGTALK_CLIENT_SECRET="YOUR_CLIENT_SECRET"
DINGTALK_BASE_URL=https://oapi.dingtalk.com/
# 日志配置
LOG_LEVEL=INFOfrom app.api.auth.dingtalk_auth import DingtalkAuth
# 初始化认证对象
auth = DingtalkAuth()
# 获取用户访问令牌
access_token, refresh_token = auth.get_user_access_token(auth_code)from app.api.client.open.openapi_client import DingtalkClient
# 初始化客户端
client = DingtalkClient(auth)
# 发送文本消息
success = client.send_text_message(
receiver_uid="user123",
text="Hello, World!",
at_user_ids=["user456"]
)# 搜索用户
users = client.search_users("张三", exact_match=True)
# 获取用户详细信息
user_info = client.get_users_info(["user123"])from app.core.mcp_server import search_users, get_user_info, send_message
# 搜索用户
result = search_users("张三")
# 获取用户信息
result = get_user_info("user123")
# 发送消息
result = send_message("张三", "Hello, World!")-
get_user_access_token(auth_code: str) -> Tuple[str, str]- 获取用户访问令牌和刷新令牌
-
get_app_access_token() -> str- 获取企业应用访问令牌
-
search_users(query_word: str, exact_match: bool = False) -> List[str]- 搜索用户，返回用户ID列表
-
get_users_info(user_ids: List[str]) -> List[Dict]- 获取用户详细信息
-
send_text_message(receiver_uid: str, text: str, at_user_ids: Optional[List[str]] = None) -> bool- 发送文本消息
-
send_markdown_message(receiver_uid: str, title: str, text: str, at_user_ids: Optional[List[str]] = None) -> bool- 发送 Markdown 消息
- 代码结构
dingtalk-agent-client/
├── app/
│ ├── api/
│ │ ├── auth/
│ │ │ └── dingtalk_auth.py
│ │ └── client/
│ │ └── open/
│ │ └── openapi_client.py
│ ├── core/
│ │ └── mcp_server.py
│ └── config/
│ └── settings.py
├── static/
│ └── resource/
│ └── iShot_2025-04-18_21.30.37.png
├── tests/
├── requirements.txt
└── README.md
- 添加新功能
- 在
app/core/mcp_server.py中注册新的 MCP 工具 - 在
app/api/client/open/openapi_client.py中添加新的 API 方法 - 在
app/core/mcp_server.py中注册新的 MCP 工具 - 添加相应的单元测试
- Fork 项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
- 项目维护者：[DarrenYao]
- 邮箱：[yao428650@gmail.com]