前言¶
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 倉庫。