feishu-doc-mcp

name	feishu-doc-mcp
description	Call Feishu document MCP tools to fetch, search, create, update Feishu docs, or manage comments. Use when the user provides Feishu wiki/doc URLs (*.feishu.cn), asks to read/create/update Feishu docs, fetch API docs from Feishu, search Feishu content, or view/add document comments.

调用飞书文档 MCP

通过 call_mcp_tool 调用飞书文档 MCP，需指定 server: "user-feishu-mcp"（按本地 MCP 配置替换）。

调用方式

{
  "server": "user-feishu-mcp",
  "toolName": "<工具名>",
  "arguments": { ... }
}

调用前：先读取工具 schema 确认参数（mcps/user-feishu-mcp/tools/<tool-name>.json）。

工具一览

操作	工具
搜索云文档	search-doc
查看云文档	fetch-doc
创建云文档	create-doc
更新云文档	update-doc
获取知识空间节点下的云文档列表	list-docs
查看全文评论与划词评论	get-comments
添加全文评论	add-comments
获取文件/图片/画板 Base64	fetch-file
搜索用户（@ 他人前需调用）	search-user
获取用户信息	get-user

常用场景

1. 读取飞书文档

用户提供 https://your-org.feishu.cn/wiki/xxx 或 https://xxx.feishu.cn/doc/xxx：

call_mcp_tool: server=user-feishu-mcp, toolName=fetch-doc, arguments={ doc_id: "完整URL或文档ID" }

doc_id 支持 URL 自动解析，无需手动提取 ID。

2. 搜索文档

call_mcp_tool: server=user-feishu-mcp, toolName=search-doc
arguments: { query: "关键词", filters: { sort_rule: "EDIT_TIME", create_time_relative: "last_7_days" } }

注意：owners 需 open_id，需先 search-user 或 get-user 获取；时间跨度 ≤ 3 个月。

3. 创建文档

call_mcp_tool: server=user-feishu-mcp, toolName=create-doc
arguments: { title: "标题", markdown: "## 内容\n\n...", wiki_node: "可选" }

wiki_node / wiki_space / folder_token 三选一。

4. 更新文档

call_mcp_tool: server=user-feishu-mcp, toolName=update-doc
arguments: { doc_id: "文档ID或URL", mode: "append", markdown: "追加内容" }

mode 可选：overwrite、append、replace_range、replace_all、insert_before、insert_after、delete_range。

定位用 selection_by_title（如 ## 章节名）或 selection_with_ellipsis（如 开头...结尾）。

5. 查看评论

call_mcp_tool: server=user-feishu-mcp, toolName=get-comments
arguments: { doc_id: "文档ID或URL", comment_type: "all|whole|segment" }

comment_type：all 全部，whole 全文评论，segment 划词评论。

6. 添加全文评论

call_mcp_tool: server=user-feishu-mcp, toolName=add-comments
arguments: { doc_id: "文档ID或URL", elements: [{type:"text",text:"..."},{type:"mention",open_id:"ou_xxx"},{type:"link",url:"..."}] }

仅支持 text、mention、link。@ 用户需先 search-user 获取 open_id。

注意事项

• fetch-doc：doc_id 必填，支持 URL，不能传文章标题
• search-doc：需 owners 时需先获取 open_id；时间跨度 ≤ 3 个月
• create-doc：正文不要重复 title；<image>、<file> 仅支持 url，不支持 token
• update-doc：优先局部更新（append/replace_range），慎用 overwrite
• get-comments：doc_id 必填；comment_type 可选 all/whole/segment
• add-comments：仅支持 text、mention、link；@ 用户需先 search-user 获取 open_id

参考

工具 schema 位于 mcps/user-feishu-mcp/tools/*.json，内含各工具的参数说明、Hard Rules 和调用示例。