Lark MCP Server

Lark MCP Server

site icon
2025.03.03 4
JavaScript协作平台AI助手集成日历管理交流协作日程管理
Lark MCP Server 是一个为 Lark/Feishu 实现的 Model Context Protocol (MCP) 服务器,它充当了 AI 模型与 Lark 协作平台之间的桥梁。通过实现 MCP 规范,该服务器使 AI 助手能够与 Lark 的各种协作功能进行交互,包括发送消息、检索和创建日历事件等。
View on GitHub

Overview

基本能力

产品定位

Lark MCP Server 是一个连接 AI 模型与 Lark/Feishu 协作平台的中间件,通过实现 MCP 协议,使 AI 助手能够利用 Lark 的协作功能。

核心功能

  • 消息发送:AI 模型可以向 Lark 用户发送直接消息。
  • 日历管理
  • 列出特定时间范围内的事件
  • 创建新的日历事件,并可自定义详细信息
  • 向事件添加各种类型的参与者(用户、群组、会议室、外部电子邮件)

适用场景

  • AI 助手与 Lark/Feishu 用户进行消息交互
  • AI 助手帮助管理个人或团队的日历安排
  • 自动化会议安排和参与者管理

工具列表

  • Node.js:运行环境
  • Lark/Feishu API:与 Lark 平台交互
  • MCP 客户端:与 AI 模型通信

常见问题解答

  • 问题:服务器无法启动 解决方案:检查环境变量是否设置正确,特别是 Lark 应用 ID 和密钥
  • 问题:权限不足 解决方案:确保 Lark 应用已获得必要的权限
  • 问题:访问令牌过期 解决方案:更新用户访问令牌

使用教程

使用依赖

  • Node.js v18 或更高版本
  • 已注册的 Lark/Feishu 应用,并具有适当的权限
  • 用于日历操作的用户访问令牌

安装教程

  1. 克隆仓库: bash git clone https://github.com/junyuan-qi/lark-mcp-server.git cd lark-mcp-server

  2. 安装依赖: bash npm install

  3. 构建项目: bash npm run build

调试方式

  • 检查服务器日志(写入 stderr)获取详细错误信息
  • 常见问题包括:
  • 缺少环境变量
  • 访问令牌不正确或已过期
  • Lark 应用权限不足
  • 请求参数无效

许可证

该项目遵循 ISC 开源许可条款。