使用说明

项目简介

Lark MCP Server 是一个基于模型上下文协议（MCP）构建的服务器，旨在连接AI模型和Lark/Feishu 协作平台。它允许AI助手通过标准化的MCP协议与Lark平台交互，实现消息发送、日历管理等功能。

主要功能点

发送Lark消息：AI模型可以向Lark用户发送文本消息。
日历管理：
- 列出日历事件：查询指定时间范围内的日历事件。
- 创建日历事件：创建新的日历事件，可设置标题、描述、时间、地点等信息。
- 添加日历事件参与者：向现有日历事件添加用户、群组、会议室或外部邮箱作为参与者。
用户搜索：在Supabase数据库中搜索用户，获取用户的Lark用户ID和日历ID，以便进行日历操作。

安装步骤

克隆仓库

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

安装依赖
```
npm install
```
构建项目
```
npm run build
```

服务器配置 (MCP 客户端配置)

以下JSON配置用于配置MCP客户端（如 Claude Desktop）连接到 Lark MCP Server。您需要将此配置添加到您的MCP客户端的服务器列表中。

{
  "mcpServers": {
    "lark-mcp-server": {
      "command": "node",
      "args": ["/path/to/lark-mcp-server/build/index.js"],
      "env": {
        "LARK_APP_ID": "YOUR_LARK_APP_ID", // 您的Lark应用App ID
        "LARK_APP_SECRET": "YOUR_LARK_APP_SECRET", // 您的Lark应用App Secret
        "LARK_USER_ID": "YOUR_LARK_USER_ID", // 用于发送消息和日历操作的Lark用户ID
        "LARK_CALENDAR_ID": "YOUR_LARK_CALENDAR_ID", // 默认使用的Lark日历ID
        "LARK_USER_ACCESS_TOKEN": "YOUR_LARK_USER_ACCESS_TOKEN", // 具备日历权限的用户Access Token
        "SUPABASE_URL": "YOUR_SUPABASE_URL", // 您的Supabase项目URL
        "SUPABASE_KEY": "YOUR_SUPABASE_KEY" // 您的Supabase项目API密钥
      }
    }
  }
}

请将 '/path/to/lark-mcp-server/build/index.js' 替换为 'index.js' 文件的实际路径，并替换 'YOUR_LARK_APP_ID' 等占位符为您的Lark和Supabase配置信息。

基本使用方法

确保已安装 Node.js 和 npm。
在 Lark/Feishu 开放平台上创建应用，并获取 App ID 和 App Secret，为应用添加日历和通讯录相关API的应用权限。
获取具备日历操作权限的 用户 Access Token。
部署 Supabase 项目，并创建一个名为 'lark_members' 的表，包含 'user_id', 'user_name', 'user_main_calendar_id' 字段，用于存储Lark用户信息。配置 Supabase 的 URL 和 API 密钥。
配置 MCP 客户端（如 Claude Desktop），将上述服务器配置添加到客户端的 'mcpServers' 中，并根据实际情况修改路径和环境变量。
启动 Lark MCP Server。MCP 客户端即可通过 MCP 协议调用服务器提供的工具，例如 'send_message_to_user'、'list_events'、'create_event'、'add_attendees'、'search_user_in_supabase' 等。

关键词