convez.ai
MCP ServerIntegração & APIsIntermediário
raynguyen256

Lark MCP Bridge

raynguyen256/Lark-CLI-MCP-Bridge

Integra Claude com Lark/Feishu para produtividade na suite colaborativa

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que conecta Claude Desktop/Code com Lark/Feishu através do lark-cli. Permite acessar documentos, calendário, drive, mensagens e outras funcionalidades do Lark/Feishu diretamente do Claude com ferramentas nativas.

Instalação

$npx convez-ai raynguyen256/Lark-CLI-MCP-Bridge

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Ler e editar documentos do Lark/Feishu via Claude
  • Consultar calendário e agenda dentro de conversas com Claude
  • Buscar arquivos no Drive do Lark/Feishu
  • Enviar mensagens automáticas para usuários/grupos
  • Automatizar fluxos que envolvem dados do Lark

Veredito

Solução sólida de integração para quem usa Lark/Feishu como suite colaborativa principal. Requer setup manual de credenciais e autenticação, mas oferece acesso bem estruturado às principais funcionalidades da plataforma através do Claude.

README

A tradução para o português deste README ainda está na fila.

Lark MCP Bridge — Hướng dẫn cài đặt và sử dụng

MCP server giúp Claude Desktop / Claude Code gọi trực tiếp vào Lark/Feishu thông qua lark-cli.


Yêu cầu hệ thống

  • macOS (đã test) hoặc Linux
  • Node.js ≥ 18
  • Claude Desktop (hoặc bất kỳ MCP client nào)

Bước 1 — Cài Node.js

Kiểm tra Node.js đã có chưa:

node --version

Nếu chưa có, cài qua nvm (khuyến nghị):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
nvm use 22

Bước 2 — Cài Lark CLI

npm install -g lark-cli

Kiểm tra:

lark-cli --version

Bước 3 — Cấu hình ứng dụng Lark (App)

Chạy lệnh khởi tạo config:

lark-cli config init

CLI sẽ hỏi lần lượt:

? Select brand:  › Lark
? App ID: cli_aa8f265206781ed2
? App Secret: <nhập App Secret của app "Lark MCP for PM">

Lưu ý: Khi được hỏi chọn app, chọn app Lark MCP for PM trên Lark Developer Console để lấy App ID và App Secret.

Kiểm tra config đã lưu:

lark-cli config show

Bước 4 — Đăng nhập tài khoản người dùng

Sau khi cấu hình app, cần đăng nhập để cấp quyền user:

lark-cli auth login

CLI sẽ trả về một URL xác thực, ví dụ:

Open this URL in your browser to authorize:
https://open.larksuite.com/open-apis/authen/v1/...

Mở URL đó trên trình duyệt → đăng nhập Lark → chấp nhận quyền → quay lại terminal.

Kiểm tra đăng nhập thành công:

lark-cli auth status

Kết quả mong đợi: hiển thị tên và email tài khoản Lark của bạn.


Bước 5 — Cài dependencies cho MCP Bridge

cd "/Users/nguyenan/Documents/Claude/Projects/Lark MCP"
npm install

Bước 6 — Đăng ký MCP vào Claude Desktop

Mở file config Claude Desktop:

~/Library/Application Support/Claude/claude_desktop_config.json

Thêm server lark-cli vào block mcpServers:

{
  "mcpServers": {
    "lark-cli": {
      "command": "node",
      "args": [
        "/Users/nguyenan/Documents/Claude/Projects/Lark MCP/index.js"
      ]
    }
  }
}

Nếu file đã có mcpServers, chỉ thêm block "lark-cli": { ... } vào bên trong — không xoá các server khác.


Bước 7 — Khởi động lại Claude Desktop

Thoát hoàn toàn và mở lại Claude Desktop.

Kiểm tra MCP đã được load: vào Settings → MCP, danh sách phải hiển thị lark-cli với trạng thái Connected.


Kiểm tra hoạt động

Thử tool cơ bản nhất trong Claude:

"Dùng lark_calendar_agenda xem lịch 3 ngày tới của tôi"

Hoặc:

"Dùng lark_drive_search tìm file tên 'Q2 Plan'"


Các công cụ (Tools) có sẵn

ToolMô tả
lark_docs_fetchĐọc nội dung tài liệu Lark/Feishu (markdown hoặc XML)
lark_docs_createTạo tài liệu mới
lark_docs_updateCập nhật tài liệu (append / overwrite / str_replace)
lark_im_sendGửi tin nhắn IM đến user hoặc group
lark_drive_searchTìm kiếm file trên Drive
lark_calendar_agendaXem lịch sắp tới
lark_cli_rawChạy bất kỳ lệnh lark-cli nào (nâng cao)

Xử lý sự cố

"command not found: lark-cli"

Đường dẫn Node/npm chưa trong PATH. Tìm đường dẫn thực:

which lark-cli

Cập nhật biến LARK_CLI ở dòng đầu index.js thành đường dẫn tuyệt đối vừa tìm được.

"permission denied" hoặc lỗi scope

Chạy lại để cấp thêm quyền:

lark-cli auth login --scope "docx:document:readonly docs:document.content:write"

Token hết hạn

lark-cli auth logout
lark-cli auth login

Kiểm tra MCP server chạy thủ công

node "/Users/nguyenan/Documents/Claude/Projects/Lark MCP/index.js"

Server không có output khi chạy bình thường — nếu không có lỗi là OK.

Ver o original no GitHub

Bom para

Relacionados