README

飞书文档 MCP 服务

一个用于读取飞书文档内容的 MCP (Model Context Protocol) 服务。

功能

read_feishu_document: 读取飞书文档的完整内容
get_feishu_document_meta: 获取文档元信息（标题）
支持普通文档和知识库（Wiki）文档

前置要求

飞书自建应用 credentials
已开通文档读取权限
Node.js >= 18

安装

npm install
npm run build

配置

复制 .env.example 为 .env
填写你的飞书应用凭证：

FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret

飞书开放平台配置

创建自建应用：https://open.feishu.cn/
获取 App ID 和 App Secret
开通权限：
- docx:document:readonly
- docx:document:read
- wiki:wiki:readonly（知识库文档需要）
发布应用（或使用调试模式）

使用方式

直接运行

# 设置环境变量
export FEISHU_APP_ID=your_app_id
export FEISHU_APP_SECRET=your_app_secret

# 运行
npm start

Claude Code 配置

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "feishu": {
      "command": "node",
      "args": ["/path/to/feishu-mcp-server/dist/index.js"],
      "env": {
        "FEISHU_APP_ID": "your_app_id",
        "FEISHU_APP_SECRET": "your_app_secret"
      }
    }
  }
}

文档 ID 获取

支持三种输入方式：

1. 普通文档

https://xxx.feishu.cn/docs/abcDEF123

文档 ID：abcDEF123

2. 知识库文档（Wiki）

https://xxx.feishu.cn/wiki/Bj3Jw2kfji45nhkK5MQcv3NynWe

直接传入完整 URL 或 Wiki 节点 ID：Bj3Jw2kfji45nhkK5MQcv3NynWe

3. 直接传入 ID

工具会自动识别是普通文档还是 Wiki 节点，并自动解析。

feishu-mcp-server

README

飞书文档 MCP 服务

功能

前置要求

安装

配置

飞书开放平台配置

使用方式

直接运行

Claude Code 配置

文档 ID 获取

1. 普通文档

2. 知识库文档（Wiki）

3. 直接传入 ID

Recommended Servers