whatevertogo/FeiShuSkill

FeiShuSkill

一键安装 Feishu MCP，通过 MCP 控制飞书

集成飞书（Feishu/Lark）服务的 AI Skill，让 AI 能够操作多维表格、文档、消息、群组等功能

📋 目录

• 项目简介
• 功能特性
• 环境要求
• 安装
• 配置飞书凭证与权限
• 快速开始
• 用法示例
• 高级配置（OAuth）
• 故障排查
• 开发与贡献
• 许可证

🌟 项目简介

FeiShuSkill 是一个基于 MCP（Model Context Protocol） 的 AI Skill，通过飞书官方 MCP 服务（@larksuiteoapi/lark-mcp）将 AI 与飞书开放平台连接，让你可以用自然语言直接控制飞书——查表格、发消息、搜文档、管群组，一句话搞定。

核心流程：

你的自然语言指令 → AI（Claude 等） → Feishu MCP 服务 → 飞书开放平台 API

✨ 功能特性

• 多维表格操作：创建表格、查询/新增/修改/删除记录
• 消息收发：发送文本、富文本消息到群组或个人
• 文档管理：搜索文档、获取内容（需 OAuth）
• 群组管理：创建群组、管理成员、获取群信息
• 权限控制：添加协作者、设置访问权限
• 联系人管理：通过邮箱/手机号获取用户信息
• 知识库操作：搜索 Wiki、获取节点信息（需 OAuth）

🖥️ 环境要求

| 依赖 | 说明 | |------|------| | Node.js ≥ 18（含 npx） | 用于运行飞书 MCP 服务 | | 支持 MCP 的 AI 客户端 | Claude Desktop、Claude Code 等 | | 飞书企业账号 | 需有权限创建企业自建应用 |

无需本地克隆本仓库——Skill 安装只需一条命令，MCP 服务通过 npx 自动拉取。

📦 安装

一键安装（推荐）

使用 OpenSkills 一键完成 Skill 安装：

npm i -g openskills
openskills install whatevertogo/FeiShuSkill

按照提示填写你的飞书 App ID 和 App Secret，安装程序会自动写入 MCP 配置。

---

手动安装：Claude Desktop

1. 在 Claude Desktop 配置文件中添加 MCP 服务器（详见配置章节）。

2. 将本项目的 lark-mcp/SKILL.md 复制到 skills 文件夹：

   • macOS：~/Library/Application Support/Claude/skills/
   • Windows：%APPDATA%\Claude\skills\
   • Linux：~/.config/Claude/skills/

3. 重启 Claude Desktop。

---

手动安装：Claude Code

# 复制 Skill 文档
cp lark-mcp/SKILL.md ~/.claude/skills/lark-mcp.md

然后按配置章节完成 MCP 服务器配置。

⚙️ 配置飞书凭证与权限

第一步：获取飞书应用凭证

1. 访问 飞书开放平台
2. 创建一个企业自建应用
3. 在「凭证与基础信息」中获取：
   • App ID（以 cli_ 开头）
   • App Secret

第二步：添加应用权限

在「权限管理」中开启所需权限（按需添加）：

| 权限标识 | 用途 | |----------|------| | bitable:app | 多维表格读写 | | im:message:send_as_bot | 发送消息 |