feishu-kb-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kb_statusA | 查看连接状态、索引规模、上次同步时间与待确认的删除提案。任何不确定时先调用它。 Args: probe: 是否实时访问一次飞书，验证权限是否仍然有效（默认只读本地，不发请求）。 |
| kb_searchA | 在全库检索（标题权重更高），返回命中页面的标题、路径、片段、node_token 与链接。 Args: query: 检索词，用你会写进标题的说法，不要用编号或缩写。 k: 返回条数，1–20，默认 8。 |
| kb_readA | 读取一页的实时正文（Markdown）、定位头、路径、修订摘要与链接。 Args: node_token: 知识库节点 token，通常来自 kb_search / kb_outline 的返回。 |
| kb_outlineA | 查看知识库目录树（默认从入口页开始，最多 3 层），用于回答“我都记了什么”。 Args: parent_node_token: 从哪个节点开始，留空表示配置里的入口页。 depth: 展开层数，1–5。 |
| kb_createA | 新建一页并写入正文。默认幂等：内容或标题与已有页重复时不会创建，而是返回原页。 Args: title: 一句话命题，不要用「杂项」「临时」，不要带两位编号（编号只给一级目录）。 markdown: 正文 Markdown；开头会自动补定位头。 parent_node_token: 父节点 token，留空表示放在入口页下。 type: 类型，笔记/来源/地图/项目/元/目录。 directory: 是否创建目录页（会补「收录判据 / 本目录索引 / 最近更新」三段）。 force: 明确知道要并列第二页时才传 true。 |
| kb_appendA | 在页面末尾追加内容（不改写原文），自动加时间与原因戳，并记录修订前镜像。 Args: node_token: 目标页面。 markdown: 要追加的 Markdown。 reason: 为什么追加（会写进页面与审计台账）。 |
| kb_replace_textA | 把页面中一段字面文字替换掉（保留样式）。用于纠错、更新过期数值、修正措辞。 这是唯一会改写原文的工具，用之前必须 kb_read 确认 search 片段准确。 |
| kb_renameB | 修改页面标题（标题即命题）。旧标题会保留为检索别名，链接不变。 |
| kb_moveB | 把页面移动到另一个父节点下。node_token 不变，旧链接继续有效。 |
| kb_propose_deleteA | 发起删除提案（AI 不能直接删除）。返回一次性提案号，必须由人在命令行确认。 |
| kb_syncA | 把飞书知识库同步到本地索引。日常用增量；结构大改或索引怀疑损坏时用 full。 Args: full: 清空本地索引后重建（不影响飞书内容）。 max_nodes: 本次最多同步多少个节点。 |
| kb_auditB | 体检：重复页、空页、缺失正文、目录过深过宽，以及按阈值给出的结构建议。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Each tool targets a distinct resource+action: search vs read vs outline for retrieval, create/append/replace_text/rename/move for different write operations, plus status, sync, audit, and a guarded delete proposal. The descriptions make the boundaries between the write tools (append at end vs literal text replacement) explicit, so an agent can reliably choose.
All tools share a consistent kb_ prefix and snake_case, mostly following a verb_noun pattern (kb_search, kb_read, kb_create, kb_move, kb_propose_delete). Two tools are noun-style (kb_status, kb_outline), a minor deviation from the verb convention but still readable and predictable.
12 tools is well within the ideal 3-15 range and each maps to a clear responsibility: discovery, reading, authoring, restructuring, maintenance, and safe deletion. Nothing appears redundant or bloated for a knowledge-base server.
The surface covers the full lifecycle: search/read/outline for retrieval, create/append/replace/rename/move for updates, guarded delete via proposal, plus sync and audit for maintenance. Minor gaps exist, such as no explicit version-history or batch-read operation, but core workflows are fully supported.