Feishu MCP Server

by ztxtxwd

Not rated
GitHub

About

An MCP server with built-in Feishu OAuth authentication, deployable on Cloudflare Workers.

Details

Author
ztxtxwd
Categories
Developer Tools, Communication, Productivity, Infrastructure, Automation

Setup

Install Feishu MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/ztxtxwd/feishu-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

An MCP server with built-in Feishu OAuth authentication, deployable on Cloudflare Workers.

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

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

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

- 与飞书官方 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 账户
- 飞书开放平台账户

# 克隆仓库 git clone <repository-url> cd open-feishu-mcp-server # 安装依赖 npm install

- 访问飞书开放平台并登录
- 点击"开发者后台"并创建一个新应用
- 在应用设置中配置权限:

- 进入"权限与功能"并添加以下权限:

-

"获取用户 ID" (auth:user.id:read)

使用步骤 2 中获得的 KV ID 更新wrangler.toml文件中的 KV 命名空间配置。
- 进入"安全设置"
- 添加重定向 URL:https://feishu-mcp-server.<your-actual-subdomain>.workers.dev/callback

- 在飞书应用的"安全设置"中添加:http://localhost:8788/callback
- 确保拥有所需的权限(同生产环境)

npx @modelcontextprotocol/inspector@latest

- 生产环境:https://feishu-mcp-server.<your-subdomain>.workers.dev/sse
- 本地环境:http://localhost:8788/sse

{ "mcpServers": { "feishu": { "url": "http://localhost:8788/sse" } } }

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

- 本地:http://localhost:8788/sse
- 生产:https://feishu-mcp-server.<your-subdomain>.workers.dev/sse

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

- ✅ 文档块树结构获取
- ✅ 获取块类型创建参数 schema
- ✅ 创建文档块(支持各种块类型)
- ✅ 更新文档块内容
- ✅ 批量删除文档块

- ✅ 表格创建与操作
- ✅ 图片、视频、文件上传与插入
- ✅ Markdown 导入功能
- ✅ 素材上传与管理
- ✅ 文档搜索

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

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

- MCP 客户端身份验证
- 飞书 OAuth 服务连接管理
- KV 存储中的安全令牌管理

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

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

- 对 MCP 客户端充当 OAuth服务器
- 对飞书 OAuth 服务充当 OAuth客户端

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

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

An MCP server with built-in Feishu OAuth authentication, deployable on Cloudflare Workers.

Zo is your personal vibe server in the cloud with 50+ tools and integrations. Add texting, email, calendar, research and more to your harness easily.

Integrates Amoga Studio with Claude Desktop for enhanced productivity and communication.

A server for interacting with DingTalk workspaces using the Model Context Protocol.

Provides various DingTalk services including contacts, department management, robot messaging, calendar, and tasks.

Automate email tasks using SMTP and IMAP protocols.

Connects AI agents to the Feishu/Lark platform for automating tasks like document processing, conversation management, and calendar scheduling.

Connect AI agents with the Feishu/Lark platform for automation, including document processing, conversation management, and calendar scheduling.

Connect AI agents with the Feishu/Lark platform for automation, including document processing, conversation management, and calendar scheduling.

Connects AI agents to the Feishu/Lark platform via its OpenAPI to automate tasks like document processing, conversation management, and calendar scheduling.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.