Thêm công cụ Ollama MCP (NanoClaw)

Hướng dẫn tích hợp Ollama MCP server để agent trong container của NanoClaw gọi và quản lý các model LLM chạy cục bộ.

Lập trìnhNâng cao★ 30,471⑂ 12,865Điểm AI 7/10Cập nhật lần cuối: 9 thg 8, 2026

Làm được gì

Skill này gắn một MCP server dạng stdio cho Ollama vào dự án NanoClaw, giúp agent trong container gọi các model LLM chạy trên máy host như những công cụ bình thường. Claude vẫn là bộ điều phối, còn phần suy luận nặng được đẩy sang model cục bộ.

Công cụ mặc định: ollama_list_models (liệt kê model đã cài), ollama_generate (chạy prompt)
Công cụ tùy chọn (OLLAMA_ADMIN_TOOLS=true): pull / delete / show model và xem model đang nạp trong RAM
Sao chép mã nguồn MCP server cùng test vào cả cây container (Bun) và host (Node), đăng ký server trong index.ts, chuyển tiếp biến môi trường OLLAMA_HOST, OLLAMA_ADMIN_TOOLS trong container-runner.ts
Đưa log [OLLAMA] lên mức info và bổ sung mẫu biến môi trường vào .env.example
Cung cấp đầy đủ lệnh build, type-check, test kết nối và một mục xử lý sự cố khá chi tiết

Dành cho ai

Người đang tự chạy NanoClaw và muốn giảm chi phí API bằng model cục bộ
Nhóm cần xử lý dữ liệu nhạy cảm mà không gửi ra API bên ngoài
Lập trình viên muốn xem ví dụ thực tế về cách tích hợp MCP stdio server vào một dự án

Lưu ý: skill sửa trực tiếp mã nguồn theo đúng cấu trúc repo NanoClaw, không dùng được cho dự án khác.

Ví dụ sử dụng

Kiểm tra kết nối lần đầu — bật daemon Ollama, ollama pull gemma3:1b, rồi nói với agent: "use ollama to tell me the capital of France".
Quản lý thư viện model — thêm OLLAMA_ADMIN_TOOLS=true vào .env, khởi động lại, rồi yêu cầu "pull the qwen3-coder:30b model" hoặc "model nào đang nằm trong RAM?".
Dùng máy Ollama từ xa — đặt OLLAMA_HOST=http://gpu-box:11434 để agent trong container gọi model trên máy GPU của công ty.

· · · Hướng dẫn cài đặt · · ·

Cài vào ứng dụng Claude (không cần terminal)

Tải tệp ZIP bằng nút bên dưới.
Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.

↓ Tải ZIP

Cài vào Claude Code

Để Claude làm — dán câu dưới đây vào Claude Code

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục .claude/skills/add-ollama-tool từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-ollama-tool/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.

Cài bằng lệnh thủ công

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-ollama-tool ~/.claude/skills/

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

Cài Ollama trên máy host và bật daemon (ollama serve hoặc app desktop).
Kiểm tra daemon: curl -s http://127.0.0.1:11434/api/tags
Nếu chưa có model nào, tải model nhẹ: ollama pull gemma3:1b
Chuẩn bị dự án NanoClaw: git clone https://github.com/nanocoai/nanoclaw.git && cd nanoclaw
Skill đã nằm sẵn tại .claude/skills/add-ollama-tool; nếu cần dùng nơi khác: cp -r nanoclaw/.claude/skills/add-ollama-tool ~/.claude/skills/
Mở Claude Code ở thư mục gốc dự án và yêu cầu: "dùng skill add-ollama-tool để tích hợp Ollama".
Theo hướng dẫn: sao chép source → đăng ký trong index.ts → thêm chuyển tiếp env trong container-runner.ts.
Chạy lần lượt các lệnh kiểm tra: pnpm run build, pnpm exec vitest run src/ollama-wiring.test.ts, (cd container/agent-runner && bun test src/ollama-registration.test.ts), ./container/build.sh
Nếu muốn, thêm OLLAMA_ADMIN_TOOLS=true hoặc OLLAMA_HOST=... vào .env rồi khởi động lại service (macOS dùng launchctl kickstart -k, Linux dùng systemctl --user restart).
Thử nói "use ollama to ..." với agent; nếu lỗi, xem log bằng tail -f logs/nanoclaw.log | grep -i ollama.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT