ardennguyen/zalo-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

5 stars 3 forks 品質 71 トレンド 33NOASSERTION

Repository Install

Zalo MCP Server for zalo-agent-cli

概要

Gói cài đặt độc lập server và CLI wrapper cho Zalo. Cho phép cài đặt toàn cục qua npm hoặc triển khai trong môi trường đóng gói (sandbox) 1-click giúp AI agents (Claude Code, Cursor) tự động hóa Zalo Personal & Official Account mà không làm rác máy tính của bạn. Cả hai cách cài đặt đều cung cấp lệnh zalo-mcp trực tiếp trên terminal. - : Là bộ mã nguồn lõi (engine). Xử lý toàn bộ logic API, login, và chứa mã nguồn thật sự của MCP Server. - : Là vỏ bọc triển khai nhanh (deployment & CLI wrapper). Nó không chứa mã nguồn lõi mà chuyển tiếp toàn bộ lệnh CLI và khởi chạy MCP Server từ @ardennguyen/zalo-agent-cli. Dù bạn cài toàn cục (npm i -g @ardennguyen/zalo-mcp) hay dùng script 1-click tạo thư mục biệt lập (tự động npm link và cấu hình .env), bạn đều có thể chạy lệnh zalo-mcp ở bất kỳ đâu. Trước khi cài đặt, hãy đảm bảo máy bạn đã có: * : Phiên bản 22 trở lên (Bắt buộc cho MCP server và CLI). * : Cần thiết để clone các bản cập nhật phụ thuộc. * : zalo-mcp 2.0.5 trở lên cần engine >=2.

README

以下は原文 README の抜粋です。原文を見る。

zalo-mcp

Gói cài đặt độc lập Model Context Protocol (MCP) server và CLI wrapper cho Zalo. Cho phép cài đặt toàn cục qua npm hoặc triển khai trong môi trường đóng gói (sandbox) 1-click giúp AI agents (Claude Code, Cursor) tự động hóa Zalo Personal & Official Account mà không làm rác máy tính của bạn. Cả hai cách cài đặt đều cung cấp lệnh zalo-mcp trực tiếp trên terminal.

Tiếng Việt | English

[!TIP] Sự khác biệt giữa zalo-mcp và zalo-agent-cli?

zalo-agent-cli: Là bộ mã nguồn lõi (engine). Xử lý toàn bộ logic API, login, và chứa mã nguồn thật sự của MCP Server.

zalo-mcp (Repo này): Là vỏ bọc triển khai nhanh (deployment & CLI wrapper). Nó không chứa mã nguồn lõi mà chuyển tiếp toàn bộ lệnh CLI và khởi chạy MCP Server từ @ardennguyen/zalo-agent-cli. Dù bạn cài toàn cục (npm i -g @ardennguyen/zalo-mcp) hay dùng script 1-click tạo thư mục biệt lập (tự động npm link và cấu hình .env), bạn đều có thể chạy lệnh zalo-mcp ở bất kỳ đâu.

📋 Yêu cầu hệ thống

Trước khi cài đặt, hãy đảm bảo máy bạn đã có:

Node.js: Phiên bản 22 trở lên (Bắt buộc cho MCP server và CLI).
Git: Cần thiết để clone các bản cập nhật phụ thuộc.
@ardennguyen/zalo-agent-cli: zalo-mcp 2.0.5 trở lên cần engine >=2.5.0 (gói tự cài đúng phiên bản). Engine 2.5.0 trở lên có đủ tool MCP mới nhất và các cờ --webhook / --webhook-secret; tool và cờ mới của engine chỉ dùng được qua zalo-mcp sau khi bạn cập nhật (.zalo-mcp.ps1 update / ./zalo-mcp.sh update, hoặc npm install -g @ardennguyen/zalo-mcp@latest nếu cài toàn cục). Engine 2.5.6 trở lên thêm webhook bền vững (mcp webhook status), /ready và /metrics, lệnh fleet cho nhiều tài khoản, và gửi tin Markdown thành định dạng thật của Zalo; mọi cờ và lệnh con này đi qua zalo-mcp như bình thường.

🚀 Bắt đầu nhanh

Bạn có thể chọn Cách 1 (Cài đặt toàn cục qua npm) hoặc Cách 2 (Cài đặt thư mục biệt lập 1 dòng lệnh). Cả hai cách đều đăng ký lệnh zalo-mcp vào PATH để bạn sử dụng ở mọi nơi.

Cách 1: Cài đặt toàn cục qua npm (Global CLI)

npm install -g @ardennguyen/zalo-mcp

Cách 2: Cài đặt thư mục cách ly (1 dòng lệnh)

Mọi phụ thuộc (dependencies) sẽ được tải vào một thư mục cách ly (zalo-mcp/), tạo file .env và tự động liên kết lệnh zalo-mcp toàn cục (npm link). Bạn có thể cài đặt ở bất kỳ đâu trên máy tính chỉ với 1 lệnh duy nhất:

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/ardennguyen/zalo-mcp/main/zalo-mcp.sh | bash -s install

Windows (PowerShell):

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "zalo": {
      "command": "zalo-mcp",
      "args": []
    }
  }
}