1.0.4 • Published 7 months ago
@ringozhang/skilled-feishu-mcp v1.0.4
Skilled Feishu MCP
一个用于与飞书文档系统集成的 Model Context Protocol (MCP) 服务器。它允许 AI 代理（如 Cherry Studio、Cursor 等）通过 MCP 接口与飞书文档交互。
功能
- 创建飞书文档
- 获取文档信息和内容
- 管理文档区块（文本、代码、标题、列表等）
- 在开发模式下使用模拟数据进行测试
快速开始
使用 npx 运行
无需安装，直接使用 npx 运行：
npx -y @ringozhang/skilled-feishu-mcp --stdio --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你的飞书应用密钥>在 Cherry Studio 中配置
在 Cherry Studio 的 MCP 服务器配置中添加以下内容：
"skilled-feishu-mcp": {
"isActive": true,
"command": "npx",
"args": [
"-y",
"@ringozhang/skilled-feishu-mcp",
"--stdio"
],
"env": {
"FEISHU_APP_ID": "<你的飞书应用ID>",
"FEISHU_APP_SECRET": "<你的飞书应用密钥>"
},
"name": "skilled-feishu-mcp"
}开发模式
通过设置 NODE_ENV=development 或使用测试凭据（以 cli_test_ 开头的 App ID），服务器将运行在开发模式。在开发模式下：
- 不会实际调用飞书 API
- 使用模拟数据进行响应
- 提供详细的日志输出
示例：
NODE_ENV=development npx -y @ringozhang/skilled-feishu-mcp --stdio --feishu-app-id=cli_test_9e11c52b0e1c500e --feishu-app-secret=test_app_secret_for_development可用工具
| 工具名 | 描述 |
|---|---|
mcp__get_feishu_doc_info | 获取飞书文档的基本信息 |
mcp__get_feishu_doc_content | 获取飞书文档的纯文本内容 |
mcp__get_feishu_doc_blocks | 获取飞书文档的区块结构 |
mcp__get_feishu_block_content | 获取特定区块的详细内容 |
mcp__update_feishu_block_text | 更新文本区块的内容和样式 |
mcp__create_feishu_document | 创建新的飞书文档 |
mcp__create_feishu_multiple_blocks | 一次创建多个不同类型的区块 |
mcp__create_feishu_single_text_block | 创建文本区块 |
mcp__create_feishu_single_code_block | 创建代码区块 |
mcp__create_feishu_single_heading_block | 创建标题区块 |
mcp__create_feishu_single_list_block | 创建列表项区块 |
mcp__get_feishu_wiki_document_id | 将 Wiki 链接转换为文档 ID |
命令行参数
--feishu-app-id: 飞书应用 ID--feishu-app-secret: 飞书应用密钥--stdio: 使用标准输入/输出进行通信（用于 Cherry Studio 等 MCP 客户端）--verbose: 启用详细日志记录--help: 显示帮助信息
飞书应用设置
- 在飞书开放平台创建一个应用
- 开启以下权限：
docx:doc:read- 读取文档docx:doc:write- 创建和更新文档
- 获取应用的 App ID 和 App Secret
许可证
MIT