feishu-mcp 0.0.4 → 0.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +39 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -7,21 +7,36 @@
|
|
|
7
7
|
## 核心功能
|
|
8
8
|
|
|
9
9
|
### 文档管理
|
|
10
|
-
-
|
|
10
|
+
- **创建飞书文档**：支持在指定文件夹中创建新的飞书文档
|
|
11
11
|
|
|
12
12
|
### 文档内容操作
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
|
|
13
|
+
- **获取文档信息**：
|
|
14
|
+
- 获取文档基本信息（标题、版本等）
|
|
15
|
+
- 获取文档区块结构和层级
|
|
16
|
+
- 获取特定区块的详细内容
|
|
17
|
+
- **获取文档纯文本内容**：支持提取文档的完整纯文本内容，便于分析和处理
|
|
18
|
+
- **编辑文档内容**：
|
|
19
|
+
- **文本块操作**：
|
|
20
|
+
- 创建和更新带有丰富样式的文本块（粗体、斜体、下划线、删除线、行内代码）
|
|
21
|
+
- 支持文本颜色设置（灰色、棕色、橙色、黄色、绿色、蓝色、紫色）
|
|
22
|
+
- 支持文本对齐方式调整（左对齐、居中、右对齐）
|
|
23
|
+
- **标题块操作**：创建从一级到九级的不同级别标题
|
|
24
|
+
- **代码块操作**：
|
|
25
|
+
- 创建多种编程语言的代码块
|
|
26
|
+
- 支持代码语法高亮
|
|
27
|
+
- 支持自动换行设置
|
|
28
|
+
- **列表操作**：
|
|
29
|
+
- 创建有序列表（编号列表）
|
|
30
|
+
- 创建无序列表（项目符号列表）
|
|
31
|
+
- **批量内容创建**：支持在单次操作中创建多个不同类型的内容块
|
|
18
32
|
|
|
19
33
|
### 计划中的功能
|
|
20
34
|
- **高级内容插入**：
|
|
35
|
+
- 表格插入：支持行列结构化数据
|
|
21
36
|
- 插入图表：支持各类数据可视化图表
|
|
22
37
|
- 插入流程图：支持流程图和思维导图
|
|
23
38
|
- 插入公式：支持数学公式和科学符号
|
|
24
|
-
-
|
|
39
|
+
- 图表、流程图的内容识别和解析
|
|
25
40
|
|
|
26
41
|
快速开始，详见[配置](#配置)部分：
|
|
27
42
|
|
|
@@ -56,7 +71,8 @@ yarn dlx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<
|
|
|
56
71
|
bunx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你的飞书应用密钥>
|
|
57
72
|
```
|
|
58
73
|
|
|
59
|
-
|
|
74
|
+
**已发布到smithery平台，可访问:https://smithery.ai/server/@cso1z/feishu-mcp**
|
|
75
|
+
|
|
60
76
|
|
|
61
77
|
关于如何创建飞书应用和获取应用凭证的说明可以在[这里](https://open.feishu.cn/document/home/develop-a-bot-in-5-minutes/create-an-app)找到。
|
|
62
78
|
|
|
@@ -124,6 +140,21 @@ bunx feishu-mcp --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你
|
|
|
124
140
|
3. 询问关于文档的问题或请求基于文档内容执行操作
|
|
125
141
|
4. 创建编辑文档都需要权限，可以到飞书开放平台对账号进行测试`https://open.feishu.cn/api-explorer/cli_a75a8ca0ac79100c?apiName=tenant_access_token_internal&from=op_doc&project=auth&resource=auth&version=v3`
|
|
126
142
|
|
|
143
|
+
## 文档权限与故障排查
|
|
144
|
+
|
|
145
|
+
### 权限类型
|
|
146
|
+
权限分为两种：机器人权限、文档访问权限
|
|
147
|
+
|
|
148
|
+
### 权限验证与排查
|
|
149
|
+
1. 获取token：[https://open.feishu.cn/api-explorer/cli_a7582508c93ad00d?apiName=tenant_access_token_internal&project=auth&resource=auth&version=v3](https://open.feishu.cn/api-explorer/cli_a7582508c93ad00d?apiName=tenant_access_token_internal&project=auth&resource=auth&version=v3)
|
|
150
|
+
2. 使用第1步获取的token，验证是否有权限访问该文档：[https://open.feishu.cn/api-explorer/cli_a7582508c93ad00d?apiName=get&project=docx&resource=document&version=v1](https://open.feishu.cn/api-explorer/cli_a7582508c93ad00d?apiName=get&project=docx&resource=document&version=v1)
|
|
151
|
+
|
|
152
|
+
### 排查方法
|
|
153
|
+
在飞书开发平台测试权限正常（在开放平台调试，失败时会有充足提示信息和指导）
|
|
154
|
+
|
|
155
|
+
### 文档授权
|
|
156
|
+
如遇到权限问题，请参考[云文档常见问题](https://open.feishu.cn/document/ukTMukTMukTM/uczNzUjL3czM14yN3MTN)，特别关注如何为应用或用户开通文档权限。
|
|
157
|
+
|
|
127
158
|
## Cursor最佳实践
|
|
128
159
|
|
|
129
160
|
添加Rules指导模型操作流程
|