@yoreland/lark-cli-mcp 1.0.1 → 1.1.0

package/README.md

@@ -56,17 +56,41 @@ npx -y @yoreland/lark-cli-mcp -- <args>  # passthrough to bundled lark-cli
 
 ---
 
-## The 7 tools
-
-| Tool                     | What it does            | lark-cli command                       |
-| ------------------------ | ----------------------- | -------------------------------------- |
-| `feishu_send_message`    | Send a message          | `im +messages-send --as user`          |
-| `feishu_get_messages`    | Read recent messages    | `im +chat-messages-list --as user`     |
-| `feishu_reply_message`   | Reply (thread optional) | `im +messages-reply --as user`         |
-| `feishu_search_messages` | Search messages         | `im +messages-search --as user`        |
-| `feishu_list_chats`      | Find group chats        | `im +chat-search --as user`            |
-| `feishu_search_user`     | Find a user (→ open_id) | `contact +search-user --as user`       |
-| `feishu_get_thread`      | View a thread           | `im +threads-messages-list --as user`  |
+## The tools
+
+### Messaging (IM)
+
+| Tool                     | What it does            |
+| ------------------------ | ----------------------- |
+| `feishu_send_message`    | Send a message          |
+| `feishu_get_messages`    | Read recent messages    |
+| `feishu_reply_message`   | Reply (thread optional) |
+| `feishu_search_messages` | Search messages         |
+| `feishu_list_chats`      | Find group chats        |
+| `feishu_search_user`     | Find a user (→ open_id) |
+| `feishu_get_thread`      | View a thread           |
+
+### Docs / Wiki / Drive
+
+| Tool                    | What it does                       |
+| ----------------------- | ---------------------------------- |
+| `feishu_search_docs`    | Search docs / wiki / sheets        |
+| `feishu_doc_fetch`      | Read a document                    |
+| `feishu_doc_create`     | Create a document (markdown)       |
+| `feishu_doc_update`     | Update a document                  |
+| `feishu_drive_search`   | Search Drive files (type filters)  |
+| `feishu_wiki_node_list` | List wiki nodes                    |
+| `feishu_wiki_node_get`  | Get a wiki node (accepts URL)      |
+
+### Bitable (multi-dimensional tables)
+
+| Tool                        | What it does                          |
+| --------------------------- | ------------------------------------- |
+| `feishu_base_table_list`    | List tables in a base                 |
+| `feishu_base_field_list`    | List fields of a table                |
+| `feishu_base_record_list`   | List records (filter/sort)            |
+| `feishu_base_record_search` | Search records                        |
+| `feishu_base_record_upsert` | Create/update a record                |
 
 ### Talk to it naturally
 
@@ -87,7 +111,7 @@ The workshop host creates **one** Feishu custom app and configures it so attende
 
 1. [Feishu Open Platform](https://open.feishu.cn) → create an internal custom app → note **App ID / App Secret**.
 2. Enable **User token scopes** matching the `im`, `contact`, `search` domains (message read/write, reply, chat read, user search, message search).
-3. Distribute the App ID/Secret to attendees via `lark-cli config` (or a pre-bound config). The login step requests scopes via `--domain im,contact`.
+3. Distribute the App ID/Secret to attendees via `lark-cli config` (or a pre-bound config). The login step requests scopes via `--domain im,contact,docs,wiki,drive,base`.
 
 `auth` uses **OAuth Device Flow**, so no `redirect URL` / `localhost:3000` callback configuration is required.
 
@@ -97,7 +121,7 @@ The workshop host creates **one** Feishu custom app and configures it so attende
 
 **`missing required scope(s)`** — re-login with the needed domain:
 ```bash
-npx -y @yoreland/lark-cli-mcp auth --domain im,contact
+npx -y @yoreland/lark-cli-mcp auth --domain im,contact,docs,wiki,drive,base
 ```
 
 **Client shows "No tools loaded"** — run `npx -y @yoreland/lark-cli-mcp doctor`; confirm Node ≥18 and that `auth status` is OK.

package/bin/cli.mjs

@@ -19,10 +19,11 @@ import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
-// Default scopes for a Feishu messaging workshop (user identity).
-// `im` domain covers send/read/reply/search; `contact` for user search.
+// Default scopes (user identity) covering IM + docs/wiki/drive/bitable.
+// `im` = messaging; `contact` = user lookup; `docs`/`wiki`/`drive` = cloud docs;
+// `base` = Bitable (multi-dimensional tables).
 // NOTE: there is no `search` domain in lark-cli; message search lives under `im`.
-const DEFAULT_DOMAINS = "im,contact";
+const DEFAULT_DOMAINS = "im,contact,docs,wiki,drive,base";
 
 function resolveLarkCli() {
   if (process.env.LARK_CLI_BIN && existsSync(process.env.LARK_CLI_BIN)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yoreland/lark-cli-mcp",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "MCP server that wraps lark-cli to operate Feishu/Lark as your own user identity (send/read/reply/search messages). Designed for one-line npx launch.",
   "type": "module",
   "bin": {

package/server.mjs

@@ -156,6 +156,192 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ["message_id"],
       },
     },
+    {
+      name: "feishu_search_docs",
+      description:
+        "搜索飞书云文档（文档/Wiki/表格），按关键词。返回标题、token、URL 等",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "搜索关键词" },
+          count: { type: "number", description: "结果数量，默认 15，最大 20" },
+        },
+        required: ["query"],
+      },
+    },
+    {
+      name: "feishu_doc_fetch",
+      description: "读取一篇飞书文档的内容（传文档 URL 或 token）",
+      inputSchema: {
+        type: "object",
+        properties: {
+          doc: { type: "string", description: "文档 URL 或 token" },
+        },
+        required: ["doc"],
+      },
+    },
+    {
+      name: "feishu_doc_create",
+      description: "新建一篇飞书文档（Markdown 内容）",
+      inputSchema: {
+        type: "object",
+        properties: {
+          title: { type: "string", description: "文档标题" },
+          markdown: { type: "string", description: "Markdown 内容" },
+          folder_token: {
+            type: "string",
+            description: "目标文件夹 token（可选）",
+          },
+        },
+        required: ["title"],
+      },
+    },
+    {
+      name: "feishu_doc_update",
+      description: "更新一篇飞书文档内容",
+      inputSchema: {
+        type: "object",
+        properties: {
+          doc: { type: "string", description: "文档 URL 或 token" },
+          markdown: { type: "string", description: "新的 Markdown 内容" },
+          mode: {
+            type: "string",
+            description:
+              "更新模式：append | overwrite | replace_all | insert_before | insert_after（默认 append）",
+          },
+          new_title: { type: "string", description: "同时更新标题（可选）" },
+        },
+        required: ["doc", "markdown"],
+      },
+    },
+    {
+      name: "feishu_drive_search",
+      description:
+        "在云盘中搜索文件（doc/sheet/bitable/file 等），支持类型筛选",
+      inputSchema: {
+        type: "object",
+        properties: {
+          query: { type: "string", description: "搜索关键词（可空，纯按筛选浏览）" },
+          doc_types: {
+            type: "string",
+            description:
+              "类型逗号分隔：doc,sheet,bitable,mindnote,file,wiki,docx,folder,slides",
+          },
+          mine: { type: "boolean", description: "仅我拥有的文档" },
+        },
+      },
+    },
+    {
+      name: "feishu_wiki_node_list",
+      description: "列出某个 Wiki 空间或父节点下的节点",
+      inputSchema: {
+        type: "object",
+        properties: {
+          space_id: {
+            type: "string",
+            description: "Wiki 空间 ID（个人库用 my_library）",
+          },
+          parent_node_token: {
+            type: "string",
+            description: "父节点 token（可选，省略则列根节点）",
+          },
+        },
+        required: ["space_id"],
+      },
+    },
+    {
+      name: "feishu_wiki_node_get",
+      description: "读取一个 Wiki 节点详情（支持传 Lark URL / node_token / obj_token）",
+      inputSchema: {
+        type: "object",
+        properties: {
+          node_token: {
+            type: "string",
+            description: "wiki node_token / obj_token / Lark URL",
+          },
+        },
+        required: ["node_token"],
+      },
+    },
+    {
+      name: "feishu_base_table_list",
+      description: "列出某个多维表格（Bitable/Base）下的所有数据表",
+      inputSchema: {
+        type: "object",
+        properties: {
+          base_token: { type: "string", description: "多维表格 app_token / URL" },
+        },
+        required: ["base_token"],
+      },
+    },
+    {
+      name: "feishu_base_field_list",
+      description: "列出多维表格某个数据表的字段（列）",
+      inputSchema: {
+        type: "object",
+        properties: {
+          base_token: { type: "string", description: "多维表格 app_token / URL" },
+          table_id: { type: "string", description: "数据表 ID（tbl_xxx）或表名" },
+        },
+        required: ["base_token", "table_id"],
+      },
+    },
+    {
+      name: "feishu_base_record_list",
+      description: "列出多维表格某个数据表的记录（行），支持筛选/排序",
+      inputSchema: {
+        type: "object",
+        properties: {
+          base_token: { type: "string", description: "多维表格 app_token / URL" },
+          table_id: { type: "string", description: "数据表 ID 或表名" },
+          limit: { type: "number", description: "返回条数 1-200，默认 100" },
+          filter_json: {
+            type: "string",
+            description: "筛选条件 JSON（与视图 filter 同结构，可选）",
+          },
+          sort_json: {
+            type: "string",
+            description: '排序 JSON，如 [{"field":"Updated","desc":true}]（可选）',
+          },
+        },
+        required: ["base_token", "table_id"],
+      },
+    },
+    {
+      name: "feishu_base_record_search",
+      description: "在多维表格数据表中检索记录",
+      inputSchema: {
+        type: "object",
+        properties: {
+          base_token: { type: "string", description: "多维表格 app_token / URL" },
+          table_id: { type: "string", description: "数据表 ID 或表名" },
+          limit: { type: "number", description: "返回条数 1-200，默认 10" },
+        },
+        required: ["base_token", "table_id"],
+      },
+    },
+    {
+      name: "feishu_base_record_upsert",
+      description:
+        "在多维表格数据表中创建或更新一条记录（给 record_id 则更新，否则创建）",
+      inputSchema: {
+        type: "object",
+        properties: {
+          base_token: { type: "string", description: "多维表格 app_token / URL" },
+          table_id: { type: "string", description: "数据表 ID 或表名" },
+          fields_json: {
+            type: "string",
+            description:
+              '字段值 JSON，如 {"Name":"Alice","Status":"Todo"}（不要包 fields）',
+          },
+          record_id: {
+            type: "string",
+            description: "记录 ID（传则更新该记录，不传则新建）",
+          },
+        },
+        required: ["base_token", "table_id", "fields_json"],
+      },
+    },
   ],
 }));
 
@@ -181,8 +367,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (chat_id) cmd.push("--chat-id", chat_id);
         else cmd.push("--user-id", user_id);
         if (count) cmd.push("--page-size", String(count));
-        if (start_time) cmd.push("--start-time", start_time);
-        if (end_time) cmd.push("--end-time", end_time);
+        if (start_time) cmd.push("--start", start_time);
+        if (end_time) cmd.push("--end", end_time);
         return await run(cmd);
       }
       case "feishu_reply_message": {
@@ -211,8 +397,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           keyword,
         ];
         if (chat_id) cmd.push("--chat-id", chat_id);
-        if (start_time) cmd.push("--start-time", start_time);
-        if (end_time) cmd.push("--end-time", end_time);
+        if (start_time) cmd.push("--start", start_time);
+        if (end_time) cmd.push("--end", end_time);
         return await run(cmd);
       }
       case "feishu_list_chats": {
@@ -245,6 +431,153 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (count) cmd.push("--page-size", String(count));
         return await run(cmd);
       }
+
+      // ---- Docs / Wiki / Drive ----
+      case "feishu_search_docs": {
+        const { query, count } = args;
+        const cmd = ["docs", "+search", "--as", "user", "--query", query];
+        if (count) cmd.push("--page-size", String(count));
+        return await run(cmd);
+      }
+      case "feishu_doc_fetch": {
+        const { doc } = args;
+        return await run(["docs", "+fetch", "--as", "user", "--doc", doc]);
+      }
+      case "feishu_doc_create": {
+        const { title, markdown, folder_token } = args;
+        const cmd = ["docs", "+create", "--as", "user", "--title", title];
+        if (markdown) cmd.push("--markdown", markdown);
+        if (folder_token) cmd.push("--folder-token", folder_token);
+        return await run(cmd);
+      }
+      case "feishu_doc_update": {
+        const { doc, markdown, mode, new_title } = args;
+        const cmd = [
+          "docs",
+          "+update",
+          "--as",
+          "user",
+          "--doc",
+          doc,
+          "--markdown",
+          markdown,
+          "--mode",
+          mode || "append",
+        ];
+        if (new_title) cmd.push("--new-title", new_title);
+        return await run(cmd);
+      }
+      case "feishu_drive_search": {
+        const { query, doc_types, mine } = args;
+        const cmd = ["drive", "+search", "--as", "user"];
+        if (query) cmd.push("--query", query);
+        if (doc_types) cmd.push("--doc-types", doc_types);
+        if (mine === true) cmd.push("--mine");
+        return await run(cmd);
+      }
+      case "feishu_wiki_node_list": {
+        const { space_id, parent_node_token } = args;
+        const cmd = [
+          "wiki",
+          "+node-list",
+          "--as",
+          "user",
+          "--space-id",
+          space_id,
+        ];
+        if (parent_node_token)
+          cmd.push("--parent-node-token", parent_node_token);
+        return await run(cmd);
+      }
+      case "feishu_wiki_node_get": {
+        const { node_token } = args;
+        return await run([
+          "wiki",
+          "+node-get",
+          "--as",
+          "user",
+          "--node-token",
+          node_token,
+        ]);
+      }
+
+      // ---- Bitable / Base ----
+      case "feishu_base_table_list": {
+        const { base_token } = args;
+        return await run([
+          "base",
+          "+table-list",
+          "--as",
+          "user",
+          "--base-token",
+          base_token,
+        ]);
+      }
+      case "feishu_base_field_list": {
+        const { base_token, table_id } = args;
+        return await run([
+          "base",
+          "+field-list",
+          "--as",
+          "user",
+          "--base-token",
+          base_token,
+          "--table-id",
+          table_id,
+        ]);
+      }
+      case "feishu_base_record_list": {
+        const { base_token, table_id, limit, filter_json, sort_json } = args;
+        const cmd = [
+          "base",
+          "+record-list",
+          "--as",
+          "user",
+          "--base-token",
+          base_token,
+          "--table-id",
+          table_id,
+        ];
+        if (limit) cmd.push("--limit", String(limit));
+        if (filter_json) cmd.push("--filter-json", filter_json);
+        if (sort_json) cmd.push("--sort-json", sort_json);
+        return await run(cmd);
+      }
+      case "feishu_base_record_search": {
+        const { base_token, table_id, limit } = args;
+        const cmd = [
+          "base",
+          "+record-search",
+          "--as",
+          "user",
+          "--base-token",
+          base_token,
+          "--table-id",
+          table_id,
+        ];
+        if (limit) cmd.push("--limit", String(limit));
+        return await run(cmd);
+      }
+      case "feishu_base_record_upsert": {
+        const { base_token, table_id, fields_json, record_id } = args;
+        const cmd = [
+          "base",
+          "+record-upsert",
+          "--as",
+          "user",
+          "--base-token",
+          base_token,
+          "--table-id",
+          table_id,
+          "--json",
+          fields_json,
+          "--format",
+          "json",
+        ];
+        if (record_id) cmd.push("--record-id", record_id);
+        return await run(cmd);
+      }
+
       default:
         return error(`未知工具: ${name}`);
     }