Hướng Dẫn Sử Dụng Serena MCP Server

Chào bạn! Bạn đã chán ngấy việc phải bỏ tiền túi ra cho các công cụ lập trình AI? Hãy cùng nói về Serena MCP Server, một viên ngọc quý miễn phí, mã nguồn mở biến LLM yêu thích của bạn thành một cỗ máy lập trình mạnh mẽ, tất cả mà không tốn kém. Được xây dựng bởi Oraios AI, Serena cho phép bạn viết mã thông minh hơn với các công cụ như Claude hoặc các mô hình mã nguồn mở, và phần tuyệt vời nhất? Bạn có thể sử dụng nó miễn phí! Trong hướng dẫn này, chúng ta sẽ tìm hiểu Serena là gì, cách cài đặt nó cho một dự án với Claude Code, và cách thiết lập Serena MCP Server trong Claude Desktop và Cursor. Hãy cùng tìm hiểu và tiết kiệm phí đăng ký cho bạn!

💡

Bạn muốn một công cụ kiểm thử API tuyệt vời có thể tạo Tài liệu API đẹp mắt?

Bạn muốn một nền tảng tích hợp, tất cả trong một để Đội ngũ Phát triển của bạn làm việc cùng nhau với năng suất tối đa?

Apidog đáp ứng mọi yêu cầu của bạn, và thay thế Postman với mức giá phải chăng hơn nhiều!

button

Serena MCP Server là gì?

Serena MCP Server là một bộ công cụ mã nguồn mở, miễn phí từ Oraios AI, biến bất kỳ mô hình ngôn ngữ lớn (LLM) nào thành một tác nhân lập trình đầy đủ chức năng. Nó sử dụng Giao thức Ngữ cảnh Mô hình (MCP) và Giao thức Máy chủ Ngôn ngữ (LSP) để cung cấp các tính năng giống như IDE, chẳng hạn như phân tích mã ngữ nghĩa, chỉnh sửa cấp độ ký hiệu và hỗ trợ đa ngôn ngữ (Python, JavaScript, Java, và nhiều hơn nữa). Dù bạn đang tái cấu trúc mã, phân tích các cơ sở mã lớn hay tạo mẫu, Serena đều xử lý tất cả—từ lập kế hoạch đến việc cam kết các thay đổi vào hệ thống kiểm soát phiên bản.

Tại sao nó tuyệt vời? Serena ra đời từ sự thất vọng với các gói đăng ký IDE đắt đỏ như Cursor hoặc Windsurf và các công cụ nặng về API như Claude Code hoặc Cline. Oraios AI muốn một giải pháp thay thế miễn phí hoạt động với các LLM mà bạn đã có, như Claude của Anthropic (ngay cả trên gói miễn phí!) hoặc các mô hình mã nguồn mở thông qua Agno. Đó là món quà của họ dành cho cộng đồng nhà phát triển, và họ tự mình sử dụng nó hàng ngày. Hơn nữa, nó được cấp phép MIT, vì vậy bạn có thể tùy chỉnh nó theo ý muốn.

Cài đặt Serena trong một dự án với Claude Code

Hãy cùng cài đặt Serena MCP Server trong dự án của bạn bằng cách sử dụng Claude Code, một trợ lý lập trình phổ biến hỗ trợ các máy chủ MCP miễn phí. Dưới đây là cách thiết lập:

Bước 1: Cài đặt các điều kiện tiên quyết

Cài đặt uv:

Serena sử dụng uv (một trình quản lý gói Python) để chạy. Cài đặt nó qua:

curl -LsSf https://astral.sh/uv/install.sh | sh

# Đối với người dùng Windows:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Hoặc sử dụng Homebrew: brew install uv.

2. Clone Kho lưu trữ của Serena:

Tải mã nguồn Serena từ GitHub:

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

3. Thiết lập Môi trường:

Sao chép tệp môi trường mẫu:

cp .env.example .env

Không cần khóa API cho gói miễn phí của Claude, nhưng nếu sử dụng mô hình trả phí, hãy thêm khóa của nó vào .env.

Bước 2: Cấu hình Serena cho Claude Code

Khởi động MCP Server:

Chạy máy chủ MCP của Serena trực tiếp từ kho lưu trữ:

uv run serena start-mcp-server

Điều này khởi động một máy chủ cục bộ với bảng điều khiển web tại http://localhost:24282/dashboard/index.html để xem nhật ký và tắt máy chủ.

2. Thêm Serena vào Claude Code:

Trong terminal của bạn, thêm Serena làm máy chủ MCP vào Claude Code:

claude mcp add-json "serena" '{"command":"uvx","args":["--from","git+https://github.com/oraios/serena","serena-mcp-server"]}'

Điều này cho Claude Code biết sử dụng máy chủ MCP của Serena mà không cần cài đặt cục bộ.

3. Kiểm tra:

Mở Claude Code, bắt đầu một cuộc trò chuyện mới và gõ:

Phân tích cơ sở mã Python của tôi trong ./src.

Serena sẽ quét dự án của bạn, lưu trữ bộ nhớ trong .serena/memories/, và cung cấp một phân tích chi tiết. Thử:

Tái cấu trúc main.py để sử dụng async/await.

Hãy xem Serena đề xuất những thay đổi mã chính xác!

Khắc phục sự cố

Máy chủ không khởi động? Đảm bảo uv đã được cài đặt và tệp .env đã được thiết lập. Kiểm tra nhật ký bảng điều khiển.
Lỗi Claude Code? Xác minh cú pháp lệnh MCP và khởi động lại Claude Code.
Sự cố về quyền? Sử dụng đường dẫn tuyệt đối (ví dụ: /path/to/serena) để tránh lỗi đường dẫn tương đối.

Sử dụng Serena MCP Server trong Claude Desktop

Claude Desktop là một cách tuyệt vời khác để sử dụng Serena MCP Server miễn phí, tận dụng gói miễn phí của Claude. Dưới đây là cách kết nối:

Bước 1: Cấu hình MCP Server

Chạy MCP Server của Serena:

Trong thư mục kho lưu trữ Serena, khởi động máy chủ:

uv run serena start-mcp-server

Hoặc sử dụng Docker (Thử nghiệm) để thiết lập gọn gàng hơn:

docker run --rm -i --network host -v /path/to/your/projects:/workspaces/projects ghcr.io/oraios/serena:latest serena start-mcp-server --transport stdio

Thay thế /path/to/your/projects bằng đường dẫn tuyệt đối của dự án của bạn.

2. Chỉnh sửa Cấu hình Claude Desktop:

Mở tệp cấu hình của Claude Desktop:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Thêm máy chủ MCP của Serena:

{
  "mcpServers": {
    "serena": {
      "command": "/path/to/uv",
      "args": ["run", "--directory", "/path/to/serena", "serena-mcp-server"]
    }
  }
}

Thay thế /path/to/uv và /path/to/serena bằng các đường dẫn thực tế (sử dụng dấu gạch chéo ngược kép \\ trên Windows).

3. Khởi động lại Claude Desktop:

Đóng và mở lại Claude Desktop. Bạn sẽ thấy biểu tượng cái búa cho biết các công cụ của Serena đang hoạt động.

Bước 2: Kiểm tra Serena trong Claude Desktop

Bắt đầu một cuộc trò chuyện:

Trong Claude Desktop, gõ:

Tóm tắt dự án của tôi trong ./myproject.

Serena sẽ phân tích cơ sở mã của bạn và trả về một bản tóm tắt, sử dụng khả năng hiểu ngữ nghĩa được hỗ trợ bởi LSP của nó.

2. Thử các tác vụ lập trình:

Hỏi:

Sửa lỗi trong src/app.js dựa trên nhật ký.

Serena sẽ đề xuất các bản sửa lỗi, lấy từ nhật ký và bộ nhớ dự án của nó trong .serena/memories/.

3. Kiểm tra Bảng điều khiển:

Truy cập http://localhost:24282/dashboard/index.html để theo dõi nhật ký hoặc tắt máy chủ.

Mẹo

Bật ghi nhật ký: Trong myproject.yml, đặt show_logs: true để dễ dàng gỡ lỗi hơn.
Kiểm soát phiên bản: Thêm .serena vào .gitignore để tránh cam kết các tệp bộ nhớ.
An toàn: Tránh execute_shell_command ở chế độ Agno mà không có xác nhận để ngăn chặn các hành động không mong muốn.

Sử dụng Serena MCP Server trong Cursor

Cursor là một IDE mạnh mẽ được hỗ trợ bởi AI, và bạn có thể sử dụng Serena MCP Server với Cursor trên toàn cầu hoặc theo từng dự án. Dưới đây là cách thực hiện:

Bước 1: Thiết lập MCP Server của Serena

Khởi động Server:

Như trước, chạy:

uv run serena start-mcp-server

Hoặc sử dụng lệnh Docker từ phần Claude Desktop.

2. Cấu hình Cursor Toàn cầu:

Mở ~/.cursor/mcp.json (trong phần "Tools and Integrations"):

{
  "mcpServers": {
    "serena": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/oraios/serena", "serena-mcp-server"]
    }
  }
}

Điều này làm cho Serena khả dụng trên tất cả các dự án Cursor.

3. Hoặc Cấu hình theo từng dự án:

Trong thư mục gốc của dự án của bạn, tạo .cursor/mcp.json với cùng cấu hình như trên.

4. Khởi động lại Cursor:

Đóng và mở lại Cursor để áp dụng các thay đổi.

Bước 2: Kiểm tra Serena trong Cursor

Mở Bảng trò chuyện của Cursor:

Trong một dự án, mở bảng trò chuyện và gõ:

Tạo một REST API trong src/api.py.

Serena sẽ tạo mã, tôn trọng cấu trúc dự án của bạn.

2. Tái cấu trúc mã:

Đánh dấu mã, nhấn Ctrl+L (hoặc Cmd+L trên macOS), và nhập:

Tối ưu hóa chức năng này để đạt hiệu suất.

Serena sẽ đề xuất các cải tiến, nhưng lưu ý rằng chế độ Chỉnh sửa có thể bị hạn chế nếu không có gói đăng ký Pro.

3. Kiểm tra Nhật ký:

Sử dụng bảng điều khiển web (http://localhost:24282/dashboard/index.html) để khắc phục sự cố.

Tại sao nên sử dụng Serena MCP Server?

Serena MCP Server là một vị cứu tinh cho các nhà phát triển đã chán ngấy chi phí đăng ký. Dưới đây là lý do tại sao nó tuyệt vời:

Miễn phí mãi mãi: Hoạt động với gói miễn phí của Claude hoặc các mô hình mã nguồn mở thông qua Agno, không cần khóa API.
Tính năng mạnh mẽ: Truy xuất mã ngữ nghĩa, chỉnh sửa cấp độ ký hiệu và hỗ trợ đa ngôn ngữ cạnh tranh với các công cụ trả phí như Cursor.
Thân thiện với quyền riêng tư: Chạy cục bộ, giữ cơ sở mã của bạn không bị lưu trữ trên các máy chủ của bên thứ ba.
Được cộng đồng hỗ trợ: Với hơn 2.9k sao trên GitHub và sự phát triển tích cực, Serena đang cải thiện nhanh chóng.

Người dùng đang rất hào hứng về Serena, với một số người gọi nó là “thiết lập lập trình mạnh nhất” khi kết hợp với Claude. Dù bạn là nhà phát triển độc lập hay làm việc trong một nhóm, Serena cho phép bạn hủy bỏ các gói đăng ký đắt đỏ đó và lập trình thông minh hơn. Sắp tới, ChatGPT Desktop có thể hỗ trợ các máy chủ MCP, mở rộng thêm các lựa chọn của bạn.

Kết luận

Serena MCP Server là tấm vé của bạn để lập trình miễn phí, được hỗ trợ bởi AI với các công cụ như Claude Code, Claude Desktop và Cursor. Từ việc cài đặt Serena đến việc chạy nó trong trình soạn thảo yêu thích của bạn, giờ đây bạn đã được trang bị để giải quyết các tác vụ lập trình mà không phải lo lắng về phí đăng ký. Hãy dùng thử, khám phá bảng điều khiển web của nó và cho tôi biết trong phần bình luận cách bạn đang sử dụng Serena để tăng cường quy trình làm việc của mình!

💡

button