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: 显示帮助信息

飞书应用设置

1. 在飞书开放平台创建一个应用
2. 开启以下权限：
   • docx:doc:read - 读取文档
   • docx:doc:write - 创建和更新文档
3. 获取应用的 App ID 和 App Secret

许可证

MIT