ardennguyen/zalo-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

5 stars 3 forks Качество 71 Тренд 27NOASSERTION

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):

Открыть полный README на GitHub

Установка

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

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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