Lark MCP Server

Lark MCP服务器

Lark/Feishu的模型上下文协议（MCP）服务器实现，使MCP兼容的应用程序能够与Lark的各种协作功能进行交互。

概述

Lark MCP Server通过实现模型上下文协议（MCP）规范，在人工智能模型和Lark的协作平台之间架起了一座桥梁。该服务器允许AI助手：

• 向Lark用户发送消息
• 检索日历事件
• 创建新的日历事件
• 将与会者添加到日历事件

服务器使用标准I/O（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

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

用法

与MCP客户端连接

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

使用Claude Desktop进行设置

您可以通过配置Claude Desktop应用程序来识别和使用Lark MCP服务器，从而将此MCP服务器与Claude Desktop集成。

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

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

1. 打开Claude Desktop应用程序，从左上角菜单栏启用开发人员模式。
2. 启用后，打开“设置”（也是从左上角菜单栏），导航到“开发人员选项”，您将在其中找到“编辑配置”按钮。点击它将打开 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服务器配置

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

{
  "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"
      }
    }
  }
}

将路径和环境变量替换为实际值。此配置告诉告诉如何启动Lark MCP服务器以及提供什么环境变量。

3.重新启动克劳德桌面

要使更改生效，请执行以下操作：

1. 完全退出Claude Desktop（不仅仅是关闭窗口）
2. 重新启动克劳德桌面
3. 在UI中查找图标，以验证Lark MCP服务器是否已连接

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

发展

项目结构

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

建筑

npm run build

这将TypeScript代码编译为JavaScript build 目录并设置可执行权限。

故障排除

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

• 缺少环境变量
• 访问令牌不正确或过期
• Lark应用程序权限不足
• 无效的请求参数

许可证

国际协调委员会

贡献

欢迎投稿！请随时提交拉取请求。

______________________________________________________________________

有关模型上下文协议的更多信息，请访问 MCP文件.

有关Lark/Feishu API的更多信息，请访问 Lark开放平台文档.