飞书 Lark MCP

功能说明

lark_tools（from veadk.tools.builtin_tools.lark import lark_tools）帮助快速集成 AI 智能体与飞书 / Lark 开放能力，实现云文档处理、会话管理、日历安排等自动化场景。它通过 npx @larksuiteoapi/lark-mcp 启动本地 MCP Server，因此需要预装 npx 与 lark-mcp。

本工具是把飞书能力作为工具提供给智能体。若需把飞书机器人的入站消息接入 VeADK Runner，请看飞书 Channel 扩展。

环境变量与前提

应用获取方式见 Lark 创建应用。

配置用于智能体推理模型的 API Key；
配置 Lark 服务的 App ID、App Secret 与 user access token。

环境变量：

MODEL_AGENT_API_KEY：智能体推理模型的 API Key
TOOL_LARK_ENDPOINT：Lark 服务的 Application ID
TOOL_LARK_API_KEY：飞书应用的 App Secret（变量名仍为 API_KEY）
TOOL_LARK_TOKEN：已授权且未过期的 user access token

先安装 Node.js 与 npm，再安装 npm install -g @larksuiteoapi/lark-mcp。确认 npx --version 和 lark-mcp -V 均可执行；工具导入时即检查这两个命令。应用需开通所用 API 的权限，并完成对应用户授权；App Secret 与用户令牌不能互相替代

使用方法

examples/tools/lark/agent.py

import asyncio

from veadk import Agent, Runner
from veadk.memory.short_term_memory import ShortTermMemory
from veadk.tools.builtin_tools.lark import lark_tools

agent = Agent(
    name="lark_agent",
    model_name="doubao-seed-2-1-pro-260628",
    description="一个飞书机器人。",
    instruction="按用户要求读取飞书数据；没有明确指令时不发送消息或修改数据。",
    tools=[lark_tools],
)

runner = Runner(agent=agent, short_term_memory=ShortTermMemory())


async def main():
    response = await runner.run("查询我能访问的日历，列出名称，不创建或修改日程")
    print(response)


if __name__ == "__main__":
    asyncio.run(main())

验证工具发现

内置实例在导入时读取凭证并创建本地 MCP 连接。先用以下代码列出当前可用工具，工具名与参数由所安装的 Lark MCP 版本决定。该内置实例没有云区域切换参数，CLOUD_PROVIDER 不会自动配置飞书与 Lark 的平台差异；需要自定义服务地址或启动参数时使用自定义 MCP

import asyncio

from veadk.tools.builtin_tools.lark import lark_tools


async def main():
    try:
        tools = await lark_tools.get_tools()
        print([tool.name for tool in tools])
    finally:
        await lark_tools.close()


if __name__ == "__main__":
    asyncio.run(main())

概览

快速开始

核心组件

可观测

扩展

前端

安全

部署

功能说明

环境变量与前提

使用方法

验证工具发现

​功能说明

​环境变量与前提

​使用方法

​验证工具发现

功能说明

环境变量与前提

使用方法

验证工具发现