Lark MCP 服务器

一个模型上下文协议 (MCP) 服务器，集成了 Lark/飞书 API，允许 LLM 与 Lark 服务进行交互。

功能

• 使用 Lark 的通讯录 API 查询员工信息
• 更多功能即将推出...

前提条件

• Node.js 16 或更高版本
• 具有 App ID 和 App Secret 的 Lark/飞书应用程序
• Claude for Desktop 或其他 MCP 客户端

安装

npm install
npm run build

使用方法

您可以通过两种方式运行服务器：

1. 使用命令行参数（推荐）

npx lark-mcp <app_id> <app_secret>

将 <app_id> 和 <app_secret> 替换为您的 Lark 应用程序凭据。

2. 使用环境变量

export LARK_APP_ID=your_app_id
export LARK_APP_SECRET=your_app_secret
npx lark-mcp

可用工具

get-user-info

使用员工 ID 检索员工信息。

在 Claude 中的使用示例：

请查找 ID 为 12345 的员工信息

开发

1. 克隆存储库
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 在开发模式下启动服务器：

   npm run dev
   

配置

服务器按以下顺序确定凭据的优先级：

1. 命令行参数
2. 环境变量
3. 默认值（如果有）

错误处理

• 服务器将在启动前验证凭据
• API 错误得到正确处理并返回给客户端
• 详细的错误消息有助于故障排除

许可证

MIT

贡献

1. Fork 存储库
2. 创建您的功能分支
3. 提交您的更改
4. 推送到分支
5. 创建一个新的 Pull Request