Chuyển đến nội dung

oraios / serena

Serena

Bộ công cụ MCP cho AI viết code hiểu mã ở mức hàm, lớp như một IDE: tìm, sửa, đổi tên xuyên nhiều file

Serena là máy chủ MCP trao cho trợ lý lập trình AI những khả năng giống một IDE: tìm hàm và lớp theo tên, xem ai đang gọi chúng, đổi tên hay di chuyển mã xuyên nhiều file bằng một lệnh. Nhờ vậy AI làm việc nhanh và chính xác hơn trên dự án lớn thay vì đọc cả file hay sửa theo số dòng. Phù hợp với lập trình viên dùng Claude Code, Codex, Cursor hay các client MCP khác.

  • 31.413 sao
  • 2.145 fork
  • Python
  • Cập nhật hôm qua
  • Giấy phép riêng, xem trên GitHub
Độ khó
Khó Dành cho người biết lập trình
Dạng
Plugin / mở rộng, Dòng lệnh (CLI)
Chạy trên
Python, Windows, macOS, Linux
Chi phí
Miễn phí hoàn toàn

Trải nghiệm khi dùng Serena

Bạn cài Serena bằng công cụ uv, chạy serena init để khởi tạo và kiểm tra, rồi cấu hình ứng dụng AI của mình để khởi chạy Serena như một máy chủ MCP. README ghi rõ không nên cài qua kho plugin hoặc marketplace vì các lệnh ở đó đã cũ.

Sau khi kết nối, trợ lý của bạn không còn đọc cả file để tìm một hàm mà gọi công cụ của Serena: tìm symbol, xem tổng quan một file, tìm nơi tham chiếu đến một hàm. Với việc như đổi tên một hàm dùng ở nhiều file, README mô tả rằng thao tác vốn cần nhiều bước mong manh có thể gói lại thành một lệnh nguyên tử.

Phía dưới Serena dùng các language server (máy chủ ngôn ngữ như trong VS Code) cho hơn 40 ngôn ngữ, hoặc plugin JetBrains trả phí nếu bạn muốn dùng phân tích của JetBrains IDE. Ngoài ra còn có hệ thống trí nhớ cho các công việc dài hơi.

Tính năng nổi bật

Tìm kiếm mã ở mức ký hiệu

Tìm hàm, lớp, tham chiếu và xem sơ đồ một file mà không phải đọc cả file, tiết kiệm ngữ cảnh của AI.

Sửa và tái cấu trúc an toàn

Đổi tên, di chuyển, thay thế theo ký hiệu thay vì thao tác trên số dòng, ít sai hơn trên dự án lớn.

Hơn 40 ngôn ngữ

Qua language server, hỗ trợ nhiều ngôn ngữ như Python, TypeScript, Java, Go, Rust, C#, PHP và nhiều ngôn ngữ khác.

Hai nền: language server hoặc JetBrains

Mặc định dùng language server miễn phí; plugin JetBrains là lựa chọn trả phí (có bản dùng thử) dùng sức mạnh phân tích của IDE.

Trí nhớ và quy trình theo dự án

Có hệ thống trí nhớ cho công việc dài và quy trình theo từng dự án, có thể cấu hình theo nhiều lớp.

Tận dụng Serena vào việc gì?

Lập trình viên làm dự án lớn

Đổi tên hàm xuyên nhiều file

Nhờ AI đổi tên một hàm và cập nhật mọi nơi dùng nó chỉ bằng một thao tác công cụ.

Lập trình viên mới vào dự án

Khám phá mã nguồn lạ

Hỏi AI về cấu trúc, ai gọi hàm này, hàm này nằm ở đâu và nhận câu trả lời dựa trên phân tích thật.

Người dùng Claude Code, Codex hằng ngày

Giảm tốn ngữ cảnh cho AI

AI chỉ lấy đoạn mã cần thiết nên tiết kiệm token và ít bị lạc hướng.

Đội phát triển hỗn hợp

Làm việc trên dự án đa ngôn ngữ

Dùng chung một bộ công cụ cho nhiều ngôn ngữ trong cùng một kho mã.

Cần chuẩn bị gì?

  • Công cụ uv là điều kiện bắt buộc duy nhất theo README.
  • Một client hỗ trợ MCP: Claude Code, Codex, Claude Desktop, OpenCode, Gemini CLI, Cursor, VS Code, JetBrains...
  • Một số ngôn ngữ cần cài thêm language server riêng; xem trang Language Support của tài liệu.
  • Tuỳ chọn plugin JetBrains trả phí nếu muốn dùng backend JetBrains.

Hướng dẫn cài đặt chi tiết

Cài trên uv (khuyên dùng)

  1. Cài uv theo hướng dẫn chính thức của Astral, rồi cài Serena. Lệnh dưới theo README và chạy được trên PowerShell hay bash.

    Terminal
    uv tool install -p 3.13 serena-agent
  2. Khởi tạo và kiểm tra thiết lập; lệnh này mặc định dùng backend language server.

    Terminal
    serena init
  3. Kết nối với ứng dụng AI. Với Claude Code, tài liệu client của Serena gợi ý lệnh tự thiết lập dưới.

    Terminal
    serena setup claude-code
  4. Hoặc thêm thủ công cho mọi dự án bằng lệnh dưới (trên Windows chạy trong Git Bash hoặc WSL vì lệnh viết cho bash).

    Terminal
    claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwd

Cài trên Claude Desktop

  1. Mở cài đặt, mục Developer, chọn sửa file cấu hình claude_desktop_config.json rồi thêm khối dưới.

    JSON
    {
      "mcpServers": {
        "serena": {
          "command": "serena",
          "args": ["start-mcp-server", "--context=desktop-app"]
        }
      }
    }
  2. Lưu file và thoát hẳn Claude Desktop (menu File, Exit) rồi mở lại để nhận cấu hình.

Dùng thử lần đầu

  1. Chạy serena init và đợi thông báo khởi tạo thành công.

  2. Cấu hình client theo tab hướng dẫn rồi mở trợ lý trong thư mục của một dự án thật nhỏ.

  3. Nhờ trợ lý nêu tổng quan các lớp và hàm chính trong dự án, và xem nó có gọi công cụ của Serena không.

  4. Thử một việc tái cấu trúc nhỏ như đổi tên một hàm ít dùng, trên nhánh Git riêng để dễ hoàn tác.

  5. Đọc hướng dẫn quy trình theo dự án và cấu hình trong user guide để tuỳ chỉnh.

Mẹo dùng hay

  • Làm việc trên nhánh Git riêng khi cho AI sửa mã để xem và hoàn tác dễ dàng.
  • Đọc trang hướng dẫn workflow theo dự án và trang cấu hình trong tài liệu chính thức để khai thác hết khả năng.
  • Với ngôn ngữ dùng language server, kiểm tra trang hỗ trợ ngôn ngữ xem có cần cài thêm gì.
  • Phiên bản 2 có giao diện agent kiểu REPL mới; xem trang tools trong tài liệu nếu muốn thử.

Lưu ý và hạn chế

  • Giấy phép theo từng thành phần: SolidLSP theo MIT, phần ứng dụng Serena theo GPL-3.0-or-later; bản phân phối kết hợp chịu GPL. Hãy cân nhắc nếu bạn muốn nhúng vào sản phẩm đóng.
  • Đóng góp mã yêu cầu chấp nhận CLA theo README.
  • Plugin JetBrains là sản phẩm trả phí (có dùng thử), Rider và CLion chưa được hỗ trợ.
  • AI vẫn có thể sửa sai; hãy luôn xem lại thay đổi trước khi commit.

Câu hỏi thường gặp

Serena có miễn phí không?

Phần chính dùng language server miễn phí. Plugin JetBrains để dùng phân tích của IDE là trả phí và có bản dùng thử.

Dùng với Claude Code được không?

Được. Tài liệu hướng dẫn cho Claude Code có lệnh thiết lập tự động và lệnh thêm thủ công, như trong phần cài đặt.

Người không lập trình có cần không?

Không. Serena dành cho người dùng trợ lý lập trình AI trong dự án code.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/oraios/serena.git

Repo tương tự nên xem

MCP: nối AI với công cụ64,9K

Context7

upstash / context7

Đưa tài liệu thư viện mới nhất, đúng phiên bản vào trợ lý AI viết code để hết cảnh AI bịa hàm không tồn tại

VừaNode.jsWindowsmacOSLinux
AI hỗ trợ lập trình156K

Claude Code

anthropics / claude-code

Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường

VừaWindowsmacOSLinux
AI hỗ trợ lập trình50,1K

Aider

Aider-AI / aider

Lập trình cặp với AI ngay trong Terminal: AI sửa code trong dự án và tự commit Git cho bạn

KhóWindowsmacOSLinuxPython

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: MCP: nối AI với công cụ

MCP: nối AI với công cụ97,8K

Awesome MCP Servers

punkpeye / awesome-mcp-servers

Danh sách tuyển chọn hàng nghìn máy chủ MCP để cho AI dùng file, trình duyệt, cơ sở dữ liệu, ứng dụng...

DễWeb
MCP: nối AI với công cụ92K

MCP Reference Servers

modelcontextprotocol / servers

Bộ máy chủ MCP mẫu chính thức: đọc file, lấy nội dung web, Git, bộ nhớ, giờ giấc cho Claude và các AI khác

VừaNode.jsPythonWindowsmacOS+1
MCP: nối AI với công cụ57,5K

Chrome DevTools MCP

ChromeDevTools / chrome-devtools-mcp

Cho trợ lý AI điều khiển và soi lỗi trang web trong Chrome thật: hiệu năng, console, mạng, ảnh chụp

VừaNode.jsWindowsmacOSLinux
MCP: nối AI với công cụ39,7K

Playwright MCP

microsoft / playwright-mcp

Cho trợ lý AI như Claude, Copilot, Cursor tự mở trình duyệt, bấm nút, điền form và đọc trang web giúp bạn

VừaNode.jsWindowsmacOSLinux
MCP: nối AI với công cụ34,6K

MCP for Blender (blender-mcp)

ahujasid / mcp-for-blender

Nối Claude hay AI khác vào Blender để dựng cảnh 3D, đổi vật liệu và tải mô hình bằng lời dặn

VừaWindowsmacOSLinuxPython
MCP: nối AI với công cụ34,5K

GitHub MCP Server

github / github-mcp-server

Máy chủ MCP chính thức của GitHub để AI đọc repo, quản lý issue, pull request và theo dõi Actions

VừaDockerWindowsmacOSLinux

Xem cả 12 repo MCP: nối AI với công cụ Về Kho Repo