mcpField
F
feishu-doc

feishu-doc

github.com/m1heng文档处理4.2k1.9k 次安装30 周前更新
代码仓库

关于 feishu-doc

面向飞书文档协作的文档操作工具说明，涵盖读取、创建、编辑、区块管理及评论操作。支持 Markdown 内容写入，但不支持 Markdown 表格。

主要功能

  1. 01读取文档文本与统计信息
  2. 02创建、替换或追加文档内容
  3. 03读取和编辑文档区块
  4. 04管理文档评论
  5. 05通过 Markdown 写入内容

适用场景

  1. 01读取飞书文档及结构化区块
  2. 02创建并填充新文档
  3. 03追加或替换文档内容
  4. 04查看或添加文档评论

MCP 相关

该技能介绍名为 `feishu_doc` 的单一工具及其文档操作参数，可供 MCP 客户端用于飞书文档读写、区块管理和评论操作。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/m1heng/clawdbot-feishu --skill feishu-doc

安装后在 Claude Code 中输入/feishu-doc确认已加载。

附带文件references/block-types.md

详细介绍

飞书文档工具

通过单个工具 feishu_doc 的 action 参数执行所有文档操作，包括评论管理。

提取令牌

从 URL https://xxx.feishu.cn/docx/ABC123def 提取 → doc_token = ABC123def 从 URL https://xxx.feishu.cn/docs/doccn123c 提取 → doc_token = doccn123c

操作

读取文档
{ "action": "read", "doc_token": "ABC123def" }

返回：标题、纯文本内容、块统计信息。检查 hint 字段——如果存在，则表示文档包含表格、图片等结构化内容，需要使用 list_blocks。

写入文档（全部替换）
{ "action": "write", "doc_token": "ABC123def", "content": "# Title\n\nMarkdown content..." }

使用 Markdown 内容替换整个文档。支持：标题、列表、代码块、引用、链接、图片（![](url) 会自动上传）、粗体/斜体/删除线。

**限制：**不支持 Markdown 表格。

创建并写入（原子操作，推荐）
{
  "action": "create_and_write",
  "title": "New Document",
  "content": "# Title\n\nMarkdown content..."
}

指定文件夹：

{
  "action": "create_and_write",
  "title": "New Document",
  "content": "# Title\n\nMarkdown content...",
  "folder_token": "fldcnXXX"
}

一次调用即可创建文档并写入内容。优先使用此操作，而不是分别执行 create 和 write。

追加内容
{ "action": "append", "doc_token": "ABC123def", "content": "Additional content" }

将 Markdown 内容追加到文档末尾。

创建文档
{ "action": "create", "title": "New Document" }

指定文件夹：

{ "action": "create", "title": "New Document", "folder_token": "fldcnXXX" }

创建空文档（仅包含标题）。

列出块
{ "action": "list_blocks", "doc_token": "ABC123def" }

返回完整块数据，包括表格和图片。使用此操作读取结构化内容。

获取单个块
{ "action": "get_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }
更新块文本
{ "action": "update_block", "doc_token": "ABC123def", "block_id": "doxcnXXX", "content": "New text" }
删除块
{ "action": "delete_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }
列出评论
{ "action": "list_comments", "doc_token": "ABC123def", "page_size": 50 }

返回文档的所有评论。使用 page_token 进行分页。评论包含 is_whole 字段，用于区分整篇文档评论（true）和块级评论（false）。

获取单条评论
{ "action": "get_comment", "doc_token": "ABC123def", "comment_id": "comment_xxx" }
创建评论
{ "action": "create_comment", "doc_token": "ABC123def", "content": "Comment text" }
列出评论回复
{ "action": "list_comment_replies", "doc_token": "ABC123def", "comment_id": "comment_xxx", "page_size": 50 }

page_size 应为正整数。若省略，工具默认设为 50。

评论写入范围

当前工具提供了文档说明中的评论写入操作 create_comment（创建全局评论）。 如需回复，请使用 list_comment_replies 获取回复；当前 SDK 接口未开放创建回复的端点。

读取工作流

  1. 从 action: "read" 开始——获取纯文本和统计信息
  2. 检查响应中的 block_types，查看是否包含 Table、Image、Code 等类型
  3. 如果存在结构化内容，请使用 action: "list_blocks" 获取完整数据

配置

channels:
  feishu:
    tools:
      doc: true  # default: true

注意：feishu_wiki 依赖此工具——通过 feishu_doc 读写知识库页面内容。

权限

必需权限：docx:document、docx:document:readonly、docx:document.block:convert、drive:drive

评论操作所需权限：

  • 读取评论：docx:document.comment:read
  • 写入评论：docx:document.comment（可选，用于 create_comment）

评论

支持 Markdown