feishu-doc-mcp 1.0.1 → 1.0.3

package/README.md

@@ -2,6 +2,32 @@
 
 一个用于访问飞书开放平台文档的 Model Context Protocol (MCP) 服务器。该服务器使 Claude 等 AI 助手能够直接搜索和阅读飞书 API 文档。
 
+## 为什么选择 Feishu Doc MCP
+
+### 零配置，无需 API Key
+
+直接对接飞书官方公开的文档接口，无需申请任何 Token 或 API Key，开箱即用。
+
+### 动态同步，永不过时
+
+分类列表从飞书 API 实时获取，自动适应官方文档结构变化，无硬编码维护负担。当飞书新增或调整 API 分类时，本工具自动同步。
+
+### 覆盖完整，4800+ 文档
+
+支持飞书开放平台全部文档体系，包括服务端 API、客户端 API、开发指南、开发教程等 100+ 个分类，涵盖即时通讯、日历、通讯录、云文档、审批、人事等全部能力。
+
+### 内容智能处理
+
+- HTML 自动转换为 Markdown，便于 AI 理解和引用
+- 大文件自动提示分段读取，保护 context window
+- 临时文件智能命名（可读前缀 + Hash），避免冲突
+
+### 高性能设计
+
+- 启动时并行加载文档索引和 URI 映射
+- 内存缓存 4800+ 文档映射，查询 O(1) 时间复杂度
+- 支持长期运行，无需反复初始化
+
 ## 功能特性
 
 - 按分类搜索飞书 API 文档

package/build/index.js

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import axios from "axios";
 import TurndownService from "turndown";
 import * as fs from "fs";
 import * as os from "os";
@@ -52,15 +51,17 @@ class FeishuDocServer {
         try {
             // 并行获取文档树和 URI 映射
             const [treeResponse, mappingResponse] = await Promise.all([
-                axios.get(DIRECTORY_LIST_URL, { timeout: 30000 }),
-                axios.get(URI_MAPPING_URL, { timeout: 30000 }),
+                fetch(DIRECTORY_LIST_URL, { signal: AbortSignal.timeout(30000) }),
+                fetch(URI_MAPPING_URL, { signal: AbortSignal.timeout(30000) }),
             ]);
-            if (treeResponse.data.code === 0) {
-                this.docTree = treeResponse.data.data.items;
+            const treeData = (await treeResponse.json());
+            const mappingData = (await mappingResponse.json());
+            if (treeData.code === 0) {
+                this.docTree = treeData.data.items;
                 console.error(`[Init] Loaded ${this.countNodes(this.docTree)} document nodes`);
             }
-            if (mappingResponse.data.code === 0) {
-                this.uriMap = mappingResponse.data.data.uriMap;
+            if (mappingData.code === 0) {
+                this.uriMap = mappingData.data.uriMap;
                 console.error(`[Init] Loaded ${Object.keys(this.uriMap).length} URI mappings`);
             }
             // 构建目录分类映射
@@ -202,14 +203,16 @@ class FeishuDocServer {
                 requestPath = this.uriMap[docPath];
             }
             // 请求文档内容
-            const response = await axios.get(DOC_DETAIL_URL, {
-                params: { fullPath: requestPath },
-                timeout: 30000,
+            const url = new URL(DOC_DETAIL_URL);
+            url.searchParams.set("fullPath", requestPath);
+            const response = await fetch(url.toString(), {
+                signal: AbortSignal.timeout(30000),
             });
-            if (response.data.code !== 0) {
-                throw new Error(`API error: ${response.data.msg || "Unknown error"}`);
+            const data = await response.json();
+            if (data.code !== 0) {
+                throw new Error(`API error: ${data.msg || "Unknown error"}`);
             }
-            const detail = response.data.data;
+            const detail = data.data;
             // 提取文档内容
             let content = "";
             // 文档标题
@@ -273,10 +276,8 @@ class FeishuDocServer {
             };
         }
         catch (error) {
-            if (axios.isAxiosError(error)) {
-                throw new Error(`Failed to fetch document: ${error.message}`);
-            }
-            throw error;
+            const message = error instanceof Error ? error.message : "Unknown error";
+            throw new Error(`Failed to fetch document: ${message}`);
         }
     }
     async run() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feishu-doc-mcp",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "MCP server for Feishu Open Platform Documentation",
   "type": "module",
   "main": "build/index.js",
@@ -39,16 +39,14 @@
   },
   "homepage": "https://github.com/ztxtxwd/feishu-doc-mcp#readme",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.1",
-    "axios": "^1.6.0",
-    "turndown": "^7.1.0",
-    "zod": "^4.2.1",
-    "zod-to-json-schema": "^3.25.0"
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "turndown": "^7.2.2",
+    "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/turndown": "^5.0.0",
-    "typescript": "^5.0.0"
+    "@types/node": "^25.0.6",
+    "@types/turndown": "^5.0.6",
+    "typescript": "^5.9.3"
   },
   "engines": {
     "node": ">=18"