Feishu

MCP开发工具

提供方 未标注

开发工具 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

一个内置飞书OAuth认证、可部署在Cloudflare Workers上的MCP服务器。

一句话选型结论

按资料字段整理

Feishu 属于开发工具类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

开发

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/inspector@latest

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Feishu当前 未标注 stdio · 本地进程 本地部署 有 未标注
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方未标注上游标注的维护方 未标注
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

7.5 KB
来自项目仓库与上游目录的原文,未做删改

飞书 MCP Server

English Documentation

这是一个支持远程连接的模型上下文协议 (MCP) 服务器,内置了飞书 OAuth 认证。

本项目修改自 cloudflare/ai/demos/remote-mcp-github-oauth,将 GitHub OAuth 替换为飞书 OAuth。

您可以将其部署到自己的 Cloudflare 账户,并在创建自己的飞书 OAuth 客户端应用后,拥有一个功能完整的远程 MCP 服务器。用户可以通过飞书账号登录连接到您的 MCP 服务器。

📋 目录

  • 与飞书官方 MCP Server 的区别
  • 特性
  • 快速开始
  • 部署方式
  • 生产环境部署
  • 本地开发环境
  • 客户端集成
  • 使用 Inspector 测试
  • 使用 Cursor
  • 使用 ChatWise
  • 访问控制
  • 工具开发路线图
  • 技术原理
  • 开发指南

🆚 与飞书官方 MCP Server 的区别

虽然飞书官方也推出了 MCP Server,但本项目在以下几个方面具有显著优势:

🎯 零配置体验

  • 本项目:用户无需手动配置任何参数,全程使用 user_access_token,过期自动刷新
  • 官方项目:需要用户手动配置多个参数,配置复杂

🚀 极致的可用性优化

  • 本项目:深度优化工具尺寸和结构,特别是文档创建块工具、创建嵌套块工具等复杂功能,确保在 Cursor 等客户端中正常使用
  • 官方项目:简单的 API 到 MCP 工具转换,部分工具过于庞大,在实际使用中存在可用性问题

🌐 前沿基础设施

  • 支持部署在 Cloudflare Workers,享受业界最前沿的边缘计算基础设施

✨ 特性

  • 🎯 零配置体验:用户无需手动配置参数,自动管理 user_access_token 和刷新
  • 🔐 飞书 OAuth 认证:安全的用户身份验证
  • 🌐 远程 MCP 服务器:支持多客户端连接
  • 🚀 Cloudflare Workers:高性能、全球分布式部署,享受业界最前沿的边缘计算基础设施
  • 🛠️ 深度优化的工具集:特别优化文档创建、嵌套块等复杂工具,确保在各种客户端中正常使用
  • 🔧 本地开发支持:便于开发和测试的本地环境
  • ⚡ 极致可用性:相比官方 MCP Server,大幅提升实际使用体验和稳定性

🚀 快速开始

前置要求

  • Node.js 18+ 和 npm
  • Cloudflare 账户
  • 飞书开放平台账户

安装```bash

克隆仓库

git clone <repository-url>
cd open-feishu-mcp-server

安装依赖

npm install


## 🚀 部署方式

### 生产环境部署

#### 步骤 1: 创建飞书应用

1. 访问飞书开放平台并登录
2. 点击&quot;开发者后台&quot;并创建一个新应用
3. 在应用设置中配置权限:
   - 进入&quot;权限与功能&quot;并添加以下权限:
     - &quot;获取用户 ID&quot; (auth:user.id:read)
     - &quot;获取用户任务信息&quot; (task:task:read)
     - &quot;获取用户授权凭证&quot; (offline_access)
     - &quot;获取用户基本信息&quot; (user_profile)

        ...
4. 记下您的**应用 ID** 和**应用密钥**

#### 步骤 2: 配置 Cloudflare 环境```bash
# 设置必要的密钥
wrangler secret put FEISHU_APP_ID
wrangler secret put FEISHU_APP_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEY  # 使用 openssl rand -hex 32 生成

# 创建 KV 命名空间
wrangler kv namespace create &quot;OAUTH_KV&quot;

步骤 3: 更新配置文件

使用步骤 2 中获得的 KV ID 更新 wrangler.toml 文件中的 KV 命名空间配置。

步骤 4: 部署服务器```bash

npm run deploy


部署完成后,记下您的实际 subdomain(会在部署日志中显示)。

#### 步骤 5: 配置重定向 URL

回到飞书应用设置:
1. 进入&quot;安全设置&quot;
2. 添加重定向 URL:`https://feishu-mcp-server..workers.dev/callback`

### 本地开发环境

#### 配置本地环境

1. **配置飞书应用**:
   - 在飞书应用的&quot;安全设置&quot;中添加:`http://localhost:8788/callback`
   - 确保拥有所需的权限(同生产环境)

2. **创建环境变量文件**:
   在项目根目录创建 `.dev.vars` 文件:```
   FEISHU_APP_ID=your_development_feishu_app_id
   FEISHU_APP_SECRET=your_development_feishu_app_secret
   COOKIE_ENCRYPTION_KEY=any_random_string_here
   ```

#### 启动本地服务器```bash
npm run dev

服务器将在 http://localhost:8788 运行。

🔌 客户端集成

使用 Inspector 测试

使用官方的 MCP Inspector 测试您的服务器:```bash
npx @modelcontextprotocol/inspector@latest


**连接地址**:
- 生产环境:`https://feishu-mcp-server..workers.dev/sse`
- 本地环境:`http://localhost:8788/sse`

### 使用 Cursor

通过一键安装按钮快速配置:

或手动配置:```json
{
  &quot;mcpServers&quot;: {
    &quot;feishu&quot;: {
      &quot;url&quot;: &quot;http://localhost:8788/sse&quot;
    }
  }
}

使用 ChatWise

  1. 配置步骤:
    - 打开 ChatWise 设置界面
    - 导航到工具选项
    - 新增命令行输入输出(stdio)
    - 命令:npx -y mcp-remote ${URL}

  2. 连接地址:
    - 本地:http://localhost:8788/sse
    - 生产:https://feishu-mcp-server..workers.dev/sse

  3. 首次使用:
    - 保存配置后会自动打开飞书 OAuth 登录页面
    - 完成授权即可使用飞书相关功能

🔐 访问控制

  • 身份验证:使用飞书 OAuth 进行用户身份验证
  • 权限范围:所有经过身份验证的飞书用户都可以访问所有工具

📋 工具开发路线图

🚧 当前开发中 (飞书文档)

  • 🔧开发辅助工具
  • ✅ 开发文档内容搜索与召回
  • 📄 文档基础操作
  • ✅ 文档块树结构获取
  • ✅ 获取块类型创建参数 schema
  • ✅ 创建文档块(支持各种块类型)
  • ✅ 更新文档块内容
  • ✅ 批量删除文档块
  • 🔧 文档高级功能
  • ✅ 表格创建与操作
  • ✅ 图片、视频、文件上传与插入
  • ✅ Markdown 导入功能
  • ✅ 素材上传与管理
  • ✅ 文档搜索

🎯 未来计划

  • 📊 电子表格(Sheets)
  • 📋 工作表基础操作(创建、删除、重命名)
  • 📋 单元格数据读写
  • 📋 公式计算与应用
  • 📋 图表创建与编辑
  • 📋 数据筛选与排序
  • 📋 协作与权限管理

  • 🗃️ 多维表格(Base/Bitable)

  • 📋 数据表基础操作
  • 📋 记录增删改查
  • 📋 字段类型管理
  • 📋 视图创建与配置
  • 📋 自动化规则设置
  • 📋 数据导入导出

...

图例:✅ 已完成 · 🔄 开发中 · 📋 计划中

🛠️ 技术原理

架构组件

OAuth Provider

完整的 OAuth 2.1 服务器实现,处理:
- MCP 客户端身份验证
- 飞书 OAuth 服务连接管理
- KV 存储中的安全令牌管理

Durable MCP

基于 Cloudflare Durable Objects 的 MCP 扩展:
- 持久状态管理
- 身份验证上下文存储
- 通过 this.props 访问用户信息
- 基于用户身份的条件工具可用性

MCP Remote

支持远程 MCP 客户端连接:
- 定义客户端-服务器通信协议
- 提供结构化工具定义方式
- 处理请求/响应序列化
- 维护 SSE 连接

👨‍💻 开发指南

MCP 服务器(由 Cloudflare Workers 提供支持)

本项目实现了双重 OAuth 角色:
* 对 MCP 客户端充当 OAuth 服务器
* 对飞书 OAuth 服务充当 OAuth 客户端

工具开发

当前工具使用用户访问令牌进行身份验证,确保:
- 安全访问飞书 API
- 基于用户权限的功能访问
- 完整的错误处理和日志记录


📝 注意:确保在部署前正确配置所有环境变量和飞书应用设置。如遇问题,请检查飞书应用权限配置和重定向 URL 设置。

Star History

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Feishu 怎么安装?

在客户端按下面的安装命令接入:npx @modelcontextprotocol/inspector@latest。装完在客户端配置里引用同一个包或端点。

Feishu 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Feishu 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Feishu 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Feishu 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Feishu 能提供哪些能力?

资料显示能力标签包括 开发。具体工具清单以官方文档为准。

Feishu 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Feishu 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。