Lark MCP Server

Lark MCP 服务

面向 Lark/Feishu 的 Model Context Protocol（MCP）服务实现，使兼容 MCP 的应用能够使用 Lark 的各项协作功能。

概述

Lark MCP 服务通过实现 Model Context Protocol（MCP）规范，在 AI 模型与 Lark 协作平台之间搭建桥梁。此服务使 AI 助手能够：

• 向 Lark 用户发送消息
• 获取日历事件
• 创建日历事件
• 为日历事件添加参与者

此服务使用标准输入/输出（stdio）传输层与 MCP 客户端通信，因此兼容支持 MCP 标准的各种 AI 模型实现。

功能

• 发送消息：AI 模型可以向 Lark 用户发送私信
• 日历管理：
  • 列出特定时间范围内的事件
  • 创建可自定义详情的新日历事件
  • 为事件添加各种类型的参与者（用户、群组、会议室、外部邮箱）

前提条件

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

安装

1. 克隆仓库：

   git clone https://github.com/junyuan-qi/lark-mcp-server.git
   cd lark-mcp-server
   

2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

使用方法

连接 MCP 客户端

此服务通过标准输入/输出（stdio）进行通信。MCP 客户端可以将其作为子进程启动，并通过其 stdin/stdout 通道进行通信，从而连接到此服务。

使用 Claude Desktop 进行设置

你可以通过配置 Claude Desktop 应用，使其识别并使用 Lark MCP 服务，从而将此 MCP 服务集成到 Claude Desktop 中。

1. 配置 Claude Desktop 以识别 Lark MCP 服务

你可以在 Claude Desktop 应用的设置中找到 claude_desktop_config.json：

1. 打开 Claude Desktop 应用，然后从左上角菜单栏启用 Developer Mode。
2. 启用后，打开 Settings（同样位于左上角菜单栏），然后前往 Developer Option，即可找到 Edit Config 按钮。点击此按钮会打开 claude_desktop_config.json 文件，你可以在其中进行必要的修改。

或者，你也可以直接从终端打开 claude_desktop_config.json：

macOS：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows：

code %APPDATA%\Claude\claude_desktop_config.json

2. 添加 Lark MCP 服务配置

将以下配置添加到 claude_desktop_config.json 的 mcpServers 部分：

{
  "mcpServers": {
    "lark-mcp-server": {
      "command": "node",
      "args": ["/path/to/lark-mcp-server/build/index.js"],
      "env": {
        "LARK_APP_ID": "your_app_id",
        "LARK_APP_SECRET": "your_app_secret",
        "LARK_USER_ID": "target_user_id",
        "LARK_CALENDAR_ID": "target_calendar_id",
        "LARK_USER_ACCESS_TOKEN": "your_user_access_token"
      }
    }
  }
}

将路径和环境变量替换为实际值。此配置会告知 Claude Desktop 如何启动 Lark MCP 服务，以及需要提供哪些环境变量。

3. 重启 Claude Desktop

要使更改生效：

1. 完全退出 Claude Desktop（不要只关闭窗口）
2. 重新启动 Claude Desktop
3. 查看界面中的图标，以确认 Lark MCP 服务已连接

连接后，Claude 将能够代表你向 Lark 用户发送消息并管理日历事件。

开发

项目结构

• src/index.ts：服务主实现
• build/：编译后的 JavaScript 文件
• package.json：项目依赖和脚本

构建

npm run build

此命令会将 TypeScript 代码编译为 build 目录中的 JavaScript，并设置可执行权限。

故障排除

查看服务日志（写入 stderr）以获取详细的错误信息。常见问题包括：

• 缺少环境变量
• 访问令牌错误或已过期
• Lark 应用权限不足
• 请求参数无效

许可证

ISC

贡献

欢迎贡献！请随时提交 Pull Request。

---

如需了解 Model Context Protocol 的更多信息，请访问 MCP 文档。

如需了解 Lark/Feishu API 的更多信息，请访问 Lark 开放平台文档。