Lark Chat

飞书 ↔ Cursor / Claude 单会话远程聊天（v0.1.0）

你在飞书发消息，本机 Agent 通过 MCP 收到并流式回复——单群、单进程、零配置。

能做什么

• 暂不支持多群并行

如何使用

1. 配置好mcp，会话中/mcp 确认是 Connected
2. 输入：> 持续监听飞书群 <随便起个群名>
3. 然后就可以远程指挥你的Claude/Cursor了

前置

• Node.js 18+
• lark-cli 已 auth login（user + bot 均 ready）
• 飞书应用已订阅 im.message.receive_v1 并发布

首次接入完整步骤见 docs/how_to_work.md。

安装

npm（推荐）

以 Claude Code 为例：

# 当前项目
claude mcp add lark-chat-mcp -- npx -y @eos./lark-chat-mcp

# 全局
claude mcp add lark-chat-mcp -s user -- npx -y @eos./lark-chat-mcp

claude mcp list

Cursor / Claude Desktop 配置：

{
  "mcpServers": {
    "lark-chat-mcp": {
      "command": "npx",
      "args": ["-y", "@eos./lark-chat-mcp"]
    }
  }
}

重载 MCP 后 新开 Agent 会话，应看到 4 个工具。

源码开发

git clone https://github.com/gitByEOS/lark-chat-mcp
cd lark-chat-mcp
npm install
npm test    # 期望全部通过

本地调试时 args 用 server.mjs 绝对路径：

{
  "mcpServers": {
    "lark-chat-mcp": {
      "command": "node",
      "args": ["/绝对路径/lark-chat-mcp/server.mjs"]
    }
  }
}

MCP 工具

单实例与事件消费

全机只能运行 一个 server.mjs：

• 第二实例会因 ~/.lark-chat-mcp/server.lock 直接退出
• 同进程并发 watch 返回 watch_busy

ps aux | grep server.mjs          # 应只有 1 个
lark-cli event status --json      # active_consumers 应为 1

环境变量（可选）

MCP 日常不用配。仅边缘场景：