前言¶
DeepSeek Harness (DSH) 依赖插件扩展能力。连接飞书 / 飞书 OpenAPI 通常需要反向代理或公共 IP。dsh-feishu-mcp 插件通过官方 MCP 服务器解决了这个问题。
插件简介¶
这是一个由 zhengjy01 维护的联网工具插件。它通过官方 @larksuiteoapi/lark-mcp 服务器将 DSH 连接到飞书。插件以子进程方式运行官方服务器,并将可用工具注册到智能体中,命名为 mcp__feishu__*。
核心功能¶
- 官方 MCP 服务器:使用 stdio 驱动官方服务器,无需反向代理或公共 IP。
- 完整工具覆盖:将官方服务器工具注册为
mcp__feishu__*。 - 身份配置:支持应用身份(appId/appSecret)或用户身份(userAccessToken)。
- Agent 工具:提供
feishu_status、feishu_config、feishu_test、feishu_tools。 - Web 设置面板:在设置中配置凭据并测试连接。
安装与启用¶
在命令行中执行以下命令:
dsh plugin --profile web add dsh-feishu-mcp
配置¶
安装后,通过 Web 设置面板(设置 -> 飞书)或 Agent 工具配置凭据。
配置应用身份:
feishu_config appId=<cli_xxx> appSecret=<your_secret>
配置用户身份(可选):
feishu_config userAccessToken=<user_access_token>
使用¶
配置完成后,Agent 将飞书工具显示为 mcp__feishu__*。使用以下命令验证连接:
feishu_test
注意事项¶
- DSH 版本要求:需要 DeepSeek Harness ≥ 0.1.5-rc.1(已验证于 0.1.5-rc.1,兼容 0.2.0-rc.2)。
- 前置条件:
- 在飞书开放平台创建一个自建应用。
- 为应用授予特定权限(例如
im:message、bitable:app、docx:document、calendar:calendar、drive:drive)。 - 发布应用版本。
- 运行机制:插件使用 stdio 运行官方 MCP 服务器,因此它以当前 DSH 进程的权限运行。
结语¶
该插件为 DSH 提供了标准化的飞书集成方式,无需复杂的网络配置。更多信息请查看 GitHub 仓库。