Tích hợp Máy chủ LSP MCP

Máy chủ “LSP” MCP dùng để làm gì?

Máy chủ LSP MCP (Model Context Protocol) đóng vai trò cầu nối giữa các máy chủ Language Server Protocol (LSP) và trợ lý AI. Bằng cách kết nối tới máy chủ LSP, nó cho phép LLM và các ứng dụng AI khác tương tác với mã nguồn thông qua các tính năng LSP chuẩn hóa. Điều này giúp công cụ AI thực hiện phân tích mã nâng cao, lấy tài liệu khi di chuột, nhận gợi ý hoàn thành mã, truy xuất thông tin chẩn đoán và thậm chí áp dụng các thao tác mã trực tiếp trong trình soạn thảo hoặc quy trình phát triển. Máy chủ LSP MCP nâng cao năng suất lập trình viên bằng cách tạo ra tương tác liền mạch giữa AI và mã nguồn, giúp các tác vụ như điều hướng mã, khắc phục lỗi và hoàn thành thông minh trở nên dễ tiếp cận và tự động hóa hơn.

Danh sách Prompts

Không có mẫu prompt cụ thể nào được liệt kê trong repository hoặc tài liệu.

Danh sách Resources

• lsp-diagnostics://
  Truy cập thông báo chẩn đoán thời gian thực (lỗi, cảnh báo, v.v.) từ các tệp đang mở, hỗ trợ cập nhật trực tiếp qua subscription.
• lsp-hover://
  Lấy thông tin giải thích tại vị trí cụ thể trong tệp, phục vụ giải thích mã theo ngữ cảnh.
• lsp-completions://
  Nhận gợi ý hoàn thành mã cho một vị trí trong tệp, hỗ trợ viết mã hiệu quả hơn.

Danh sách Tools

• get_info_on_location
  Lấy thông tin hover (tài liệu) tại một vị trí xác định trong tệp.
• get_completions
  Cung cấp gợi ý hoàn thành mã tại vị trí chỉ định.
• get_code_actions
  Truy xuất các thao tác mã khả dụng (ví dụ: quick fix) cho một vùng trong tệp.
• open_document
  Mở tệp trên máy chủ LSP để phân tích và tương tác.
• close_document
  Đóng tệp đã mở trong ngữ cảnh máy chủ LSP.
• get_diagnostics
  Lấy thông báo chẩn đoán (lỗi, cảnh báo) cho các tệp đang mở.
• start_lsp
  Khởi động máy chủ LSP với thư mục gốc được chỉ định.
• restart_lsp_server
  Khởi động lại phiên bản máy chủ LSP mà không cần khởi động lại máy chủ MCP.
• set_log_level
  Thay đổi động mức độ log của máy chủ khi đang chạy.

Các trường hợp sử dụng máy chủ MCP này

• Khám phá mã nguồn
  Lập trình viên và agent AI có thể truy vấn thông tin hover và gợi ý hoàn thành, giúp hiểu và điều hướng codebase lớn dễ dàng hơn.
• Tự động review code & phát hiện lỗi
  Thông qua truy cập chẩn đoán và thao tác mã, công cụ AI có thể làm nổi bật lỗi và gợi ý sửa lỗi khi review hoặc CI.
• Hoàn thành mã thông minh
  LLM có thể tận dụng hoàn thành thực tế của LSP để đưa ra đề xuất chính xác và phù hợp ngữ cảnh khi viết hoặc refactor mã.
• Học tập tương tác & tài liệu
  Trợ lý AI có thể lấy thông tin hover và tài liệu theo yêu cầu, tăng cường học tập và onboarding cho developer mới.
• Tích hợp trình soạn thảo và IDE
  Máy chủ có thể tích hợp vào editor để cung cấp các tính năng AI thời gian thực như đề xuất sửa lỗi hoặc giải thích đoạn mã.

Hướng dẫn thiết lập

Windsurf

1. Đảm bảo bạn đã cài đặt Node.js (v16+) và npm.
2. Xác định tệp cấu hình Windsurf của bạn.
3. Thêm Máy chủ LSP MCP vào phần mcpServers:

   {
     "mcpServers": {
       "lsp-mcp": {
         "type": "stdio",
         "command": "npx",
         "args": [
           "tritlo/lsp-mcp",
           "<language-id>",
           "<path-to-lsp>",
           "<lsp-args>"
         ]
       }
     }
   }
   

4. Lưu cấu hình và khởi động lại Windsurf.
5. Xác minh tích hợp bằng cách chạy lệnh LSP thử nghiệm.

Claude

1. Cài đặt Node.js (v16+) và npm.
2. Tìm tệp cấu hình Claude.
3. Thêm Máy chủ LSP MCP vào phần mcpServers:

   {
     "mcpServers": {
       "lsp-mcp": {
         "type": "stdio",
         "command": "npx",
         "args": [
           "tritlo/lsp-mcp",
           "<language-id>",
           "<path-to-lsp>",
           "<lsp-args>"
         ]
       }
     }
   }
   

4. Lưu thay đổi, khởi động lại Claude và xác minh bằng cách chạy claude --mcp-debug để xem log.
5. Đảm bảo máy chủ khởi động thành công và xử lý các lệnh LSP.

Cursor

1. Xác nhận Node.js (v16+) và npm đã được cài đặt.
2. Mở tệp cấu hình của Cursor.
3. Thêm Máy chủ LSP MCP:

   {
     "mcpServers": {
       "lsp-mcp": {
         "type": "stdio",
         "command": "npx",
         "args": [
           "tritlo/lsp-mcp",
           "<language-id>",
           "<path-to-lsp>",
           "<lsp-args>"
         ]
       }
     }
   }
   

4. Lưu và khởi động lại Cursor.
5. Thử mở một dự án và kiểm tra phản hồi LSP.

Cline

1. Cài đặt Node.js (v16+) và npm.
2. Chỉnh sửa tệp cấu hình Cline.
3. Thêm vào nội dung sau:

   {
     "mcpServers": {
       "lsp-mcp": {
         "type": "stdio",
         "command": "npx",
         "args": [
           "tritlo/lsp-mcp",
           "<language-id>",
           "<path-to-lsp>",
           "<lsp-args>"
         ]
       }
     }
   }
   

4. Lưu và khởi động lại Cline.
5. Kiểm tra thiết lập bằng cách chạy các lệnh liên quan đến LSP trong giao diện.

Bảo mật khóa API

Nếu máy chủ LSP hoặc cấu hình MCP cần khóa API, hãy dùng biến môi trường để bảo mật:

{
  "mcpServers": {
    "lsp-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "tritlo/lsp-mcp",
        "<language-id>",
        "<path-to-lsp>",
        "<lsp-args>"
      ],
      "env": {
        "API_KEY": "${LSP_API_KEY}"
      },
      "inputs": {
        "api_key": "${LSP_API_KEY}"
      }
    }
  }
}

Cách sử dụng MCP này trong flows

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào quy trình FlowHunt, bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối với agent AI của bạn:

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP hệ thống, chèn thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "lsp-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, agent AI sẽ có thể sử dụng MCP này như một công cụ với đầy đủ chức năng. Hãy thay “lsp-mcp” thành tên thực tế của máy chủ MCP của bạn và thay đổi URL thành đường dẫn máy chủ MCP của bạn.

Tổng quan

Đánh giá của chúng tôi

Máy chủ LSP MCP có tài liệu đầy đủ, nhiều công cụ và resource hỗ trợ tương tác LSP, cùng hướng dẫn cài đặt dễ hiểu. Tuy nhiên, nó chưa hỗ trợ prompt template rõ ràng và không đề cập tới sampling hoặc hỗ trợ roots. Tổng thể, đây là giải pháp tốt cho tích hợp codebase và LSP, nhưng sẽ tuyệt vời hơn nếu có thêm các tính năng MCP nâng cao.

Đánh giá: 7/10

Điểm MCP