MCP — Connect Hermes to Thousands of Tools | Easy Understand Hermes Agent

MCP — Kết nối Hermes với hàng nghìn công cụ

Nếu bạn từng ước Hermes có thể dùng một công cụ đã tồn tại ở đâu đó — một bot GitHub, một client database, một trình duyệt file, một API nội bộ — thì MCP (Model Context Protocol) là cách sạch sẽ nhất để biến điều đó thành hiện thực.

MCP cho phép Hermes kết nối tới các máy chủ công cụ bên ngoài, nhờ đó agent có thể dùng các công cụ nằm ngoài phạm vi Hermes. Hãy nghĩ về nó như một bộ chuyển đổi vạn năng: thay vì phải viết một công cụ Hermes gốc từ đầu, bạn chỉ cần trỏ Hermes tới một máy chủ MCP và nó sẽ tự tìm ra những công cụ nào đang khả dụng.

MCP mang lại cho bạn điều gì

Truy cập vào hệ sinh thái công cụ bên ngoài mà không cần viết công cụ Hermes gốc trước
Hỗ trợ cả máy chủ cục bộ và từ xa — máy chủ stdio và máy chủ MCP HTTP hoạt động trong cùng một cấu hình
Tự động khám phá công cụ khi khởi động — Hermes tự tìm và đăng ký mọi thứ
Bộ bọc tiện ích cho tài nguyên và prompt của MCP khi máy chủ hỗ trợ
Lọc theo từng máy chủ — chỉ hiển thị những công cụ MCP mà bạn thực sự muốn Hermes thấy

Bắt đầu nhanh

Hỗ trợ MCP đi kèm với bản cài đặt tiêu chuẩn — không cần thêm bước nào. Đây là cách bắt đầu:

1. Thêm một máy chủ MCP vào ~/.hermes/config.yaml:

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]

2. Khởi động Hermes:

hermes chat

3. Yêu cầu Hermes sử dụng khả năng hỗ trợ bởi MCP.

Ví dụ:

Liệt kê các file trong /home/user/projects và tóm tắt cấu trúc repo.

Hermes sẽ tự khám phá các công cụ của máy chủ MCP và sử dụng chúng như bất kỳ công cụ nào khác. Chỉ vậy thôi — không cần cấu hình thêm, không cần cú pháp đặc biệt.

Danh mục: cài đặt một chạm cho các MCP được Nous phê duyệt

Hermes đi kèm với một danh mục tuyển chọn các máy chủ MCP mà đội ngũ Nous đã xem xét và hợp nhất. Chúng bị tắt theo mặc định — chỉ cài những gì bạn thực sự muốn.

hermes mcp                # trình chọn tương tác (mặc định)
hermes mcp catalog        # danh sách dạng văn bản thuần, có thể viết script
hermes mcp install n8n    # cài một mục trong danh mục theo tên

Trình chọn hiển thị từng mục với trạng thái hiện tại:

n8n          available              Quản lý và kiểm tra workflow n8n từ Hermes
linear       enabled                Quản lý issue/project Linear (OAuth từ xa)
github       installed (disabled)   Công cụ repo GitHub + PR

Nhấn Enter trên một dòng để cài đặt, bật, tắt hoặc gỡ cài đặt. Các mục trong danh mục có thể yêu cầu các loại thông tin xác thực khác nhau:

API key — Hermes nhắc nhập lúc cài đặt và ghi giá trị vào ~/.hermes/.env
OAuth (MCP từ xa) — được ghi dưới dạng auth: oauth trong cấu hình của bạn; MCP client mở trình duyệt ở lần kết nối đầu tiên
OAuth (nhà cung cấp bên thứ ba) — Hermes trỏ bạn tới hermes auth <provider> nếu bạn chưa xác thực

Chọn công cụ lúc cài đặt

Sau khi cấu hình thông tin xác thực, Hermes thăm dò máy chủ MCP để liệt kê mọi công cụ nó hiển thị và đưa ra một danh sách kiểm tra:

Chọn công cụ cho 'linear' (SPACE để chuyển, ENTER để xác nhận)
  [x] find_issues       Tìm issue khớp với truy vấn
  [x] get_issue         Lấy một issue cụ thể
  [x] create_issue      Tạo issue mới
  [ ] delete_workspace  Xóa một Linear workspace
  ...

Các dòng được đánh dấu sẵn đến từ:

Lựa chọn trước đó của bạn nếu bạn đã cài mục này trước đây
tools.default_enabled trong manifest nếu mục đó khai báo
Tất cả nếu không có trường hợp nào ở trên

Gửi danh sách kiểm tra bằng phím ENTER. Chỉ những công cụ được đánh dấu mới được đưa vào mcp_servers.<tên>.tools.include. Nếu bạn chọn tất cả, không có bộ lọc nào được ghi — cấu hình gọn gàng nhất, hành vi giống hệt.

Nếu việc thăm dò thất bại (máy chủ không truy cập được, OAuth chưa hoàn tất), việc cài đặt vẫn thành công: các mặc định của manifest được áp dụng trực tiếp, hoặc không có bộ lọc nào được ghi. Chạy lại hermes mcp configure <tên> khi máy chủ truy cập được để tinh chỉnh.

Mô hình tin cậy

Cài đặt một mục trong danh mục sẽ chạy bất cứ thứ gì manifest chỉ định — git clone, các lệnh bootstrap, và cuối cùng là mã của chính máy chủ MCP. Các manifest được kiểm duyệt qua đánh giá PR vào repo hermes-agent, vì vậy Nous đã xem xét từng mục trước khi phát hành — nhưng bạn vẫn nên đọc manifest trước khi cài đặt, đặc biệt là trường source: (kho lưu trữ), các lệnh install.bootstrap: và bất kỳ lời gọi transport.command: nào.

Các manifest nằm tại optional-mcps/<tên>/manifest.yaml trên GitHub. Trình chọn in URL source: của manifest lúc cài đặt để bạn có thể nhanh chóng xác minh repo thượng nguồn. Trang MCP trên web dashboard hiển thị cùng chi tiết đó cho từng mục trong danh mục — transport, loại xác thực, URL endpoint, nguồn cài đặt git, lệnh bootstrap và ghi chú thiết lập — với source: được hiển thị dưới dạng liên kết có thể nhấp.

Tương thích phiên bản manifest

Các manifest ghim một manifest_version. Danh mục tương thích tiến: nếu một PR thêm mục có phiên bản mới hơn những gì Hermes đã cài của bạn hiểu, trình chọn sẽ hiển thị cảnh báo (⚠ '<tên>' yêu cầu Hermes mới hơn) thay vì âm thầm ẩn nó. Chạy hermes update để cài Hermes mới nhất khi bạn thấy điều đó.

Thay thế `${ENV_VAR}` lúc chạy

Bên trong transport.command, transport.args, transport.url và headers của một mục, các placeholder ${VAR} được giải quyết lúc chạy từ môi trường của bạn — nhờ đó bạn có thể giữ bí mật ngoài cấu hình và tham chiếu chúng một cách linh hoạt.

Đến từ Claude Code?

Khối mcpServers trong ~/.claude.json của bạn ánh xạ tới mcp_servers trong config.yaml của Hermes — và hermes import-agent claude-code tự động di chuyển nó (cùng với skills và instructions).

MCP là cách nhanh nhất để trao cho Hermes siêu năng lực mà không cần phát minh lại bánh xe. Hãy thử ngay hôm nay.