跳到主要内容
dsh marketplace

dsh-feishu-mcp

已验证

dsh-feishu-mcp · v0.1.3 · MIT · Web 界面

Feishu (Lark) OpenAPI MCP connection for DeepSeek Harness: drives the official @larksuiteoapi/lark-mcp stdio server with your Feishu app credentials, exposes Feishu API tools (IM messages, Bitable, docs, calendar, drive) under mcp__feishu__*, and a web se

安装

dsh plugin add dsh-feishu-mcp

用 dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南。

源码

标签

说明文档

dsh-feishu-mcp — 飞书（Lark）MCP 连接插件 for DeepSeek Harness

把 DeepSeek Harness（DSH）与飞书开放平台打通：插件以子进程方式驱动官方 @larksuiteoapi/lark-mcp 服务器，用你的飞书应用凭据启动它，发现其工具并注册为 agent 的 mcp__feishu__* 工具——DSH agent 即可用你飞书应用的权限发送 IM 消息、读写多维表格（Bitable）、管理云文档、日历、云盘等。

Web 设置面板（设置 → 飞书）配置 App ID / App Secret、显示连接状态、列出发现的工具。

English README: README.md

特性

  • 官方 MCP 服务器：stdio 方式驱动 @larksuiteoapi/lark-mcp（飞书 OpenAPI MCP，Beta），无需公网 IP、无需反向代理。
  • 完整工具面：官方服务器暴露的所有工具（取决于你的应用权限与 -t 预设）都会成为 agent 工具 mcp__feishu__*——例如 mcp__feishu__im_v1_message_create、mcp__feishu__bitable_v1_app_create。
  • 应用身份或用户身份：配置 appId/appSecret（应用身份，tenant），可选 userAccessToken（用户身份，访问私有资源）。
  • 浏览器跳转授权（OAuth 2.0）：一键「登录授权」——在浏览器登录飞书并同意授权后，自动回填 user_access_token 与 refresh_token（含自动刷新），不必手动复制粘贴令牌。与 dsh-gmail-mcp / dsh-vercel-mcp 同款体验。
  • agent 工具：feishu_status / feishu_config / feishu_test / feishu_tools / feishu_oauth_start / feishu_oauth_finish / feishu_oauth_refresh。
  • Web 设置面板：配置凭据、登录授权、刷新令牌、测试连接、查看实时工具列表。

兼容性

要求 DeepSeek Harness ≥ 0.1.5-rc.1（已在包清单的 dsh.engines.dsh 中声明，DSH 插件市场据此显示兼容版本），并已在 0.1.5-rc.1 上实测通过。本构建包含 DSH 0.1.5 的适配：工具结果的严格校验契约（lossless-JSON 快照、additionalProperties: false 的 schema 校验、output.render 必须返回 ContentBlock[]），以及不依赖宿主 PATH 的可执行文件解析（launchd 托管的宿主 PATH 只有 /usr/bin:/bin）。 本版起在 peerDependencies 中显式声明兼容 DSH 0.2.0-rc.2（官方 DSH 包的版本范围已含 ^0.2.0-rc.2），在 0.2.0-rc.2 上不会再出现兼容告警；功能与行为无变化。

前置条件

  1. 一个飞书自建应用：飞书开放平台 → 开发者后台 → 创建应用。
  2. 添加所需权限（im:message、bitable:app、docx:document、calendar:calendar、drive:drive 等）并发布版本。
  3. 若要用用户身份访问私有资源：在应用「安全设置 → 重定向 URL」加入回调地址 http://127.0.0.1:3080/api/dsh-feishu/oauth/callback。
  4. 安装插件并配置 App ID / App Secret。

安装

# 本地开发（link）
# from npm (published package)
dsh plugin --profile web add dsh-feishu-mcp

# or local development
dsh plugin --profile web add link:/path/to/dsh-feishu-mcp
# 重启 dsh web 生效

配置

通过 Web 设置面板（设置 → 飞书），或用 agent 工具：

feishu_config appId=<cli_xxx> appSecret=<你的secret>

可选用户身份（两种方式任选）：

# 方式一：手动粘贴令牌
feishu_config userAccessToken=<user_access_token>

# 方式二：浏览器跳转授权（推荐）
feishu_oauth_start            # 返回飞书授权链接，让用户在浏览器登录授权
# 授权完成后自动回填 user_access_token + refresh_token
feishu_oauth_refresh          # 令牌临近过期时手动刷新

授权时的 scope 默认 offline_access（仅拿到刷新令牌）；若要用户身份调用 API，需在「授权 scope」里加上所需权限并与 offline_access 一起提交，例如 im:message offline_access。用户身份令牌有效期约 2 小时，插件会在临近过期时自动用 refresh_token 刷新并重连。

使用

连接成功后，agent 会把飞书工具以 mcp__feishu__* 前缀暴露。验证：

feishu_test

开发

pnpm install
pnpm build && node tests/smoke.mjs

License

MIT