Tích Hợp Máy Chủ Star Wars MCP

Máy chủ “Star Wars” MCP làm gì?

Star Wars MCP Server là một máy chủ Model Context Protocol (MCP) được thiết kế để tương tác với API SWAPI Star Wars. Mục đích chính là minh họa cách một máy chủ MCP có thể làm cầu nối giữa trợ lý AI và các API bên ngoài, cho phép mở rộng quy trình phát triển. Bằng cách kết nối với SWAPI, máy chủ giúp các client AI truy vấn và lấy dữ liệu về vũ trụ Star Wars như nhân vật, hành tinh, tàu vũ trụ, v.v. Khả năng này cho phép các công cụ AI mang đến trải nghiệm người dùng phong phú hơn, tự động hóa việc truy xuất thông tin và tối ưu hóa các tác vụ liên quan đến dữ liệu Star Wars, đồng thời trình diễn sức mạnh của MCP trong việc tích hợp API bên thứ ba vào quy trình AI sử dụng LLM.

Danh sách Prompt

Không tìm thấy thông tin về mẫu prompt trong kho lưu trữ.

Danh sách Resource

Không tìm thấy danh sách tài nguyên Model Context Protocol rõ ràng trong kho lưu trữ.

Danh sách Tool

Không tìm thấy định nghĩa công cụ rõ ràng (ví dụ: query_database, call_api). Kho lưu trữ được mô tả là một máy chủ MCP để tương tác với SWAPI, nhưng giao diện tool cụ thể không được ghi tài liệu trong các tệp nhìn thấy được.

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

• Tích hợp API cho dữ liệu Star Wars
  Lập trình viên có thể sử dụng máy chủ như một cầu nối với SWAPI, cho phép tác nhân AI lấy thông tin chi tiết về vũ trụ Star Wars cho ứng dụng, chatbot hoặc công cụ giáo dục.

• Tự động tạo câu hỏi kiến thức
  Bằng cách tận dụng máy chủ MCP, các trò chơi kiến thức và trắc nghiệm có thể tự động tạo câu hỏi và đáp án từ dữ liệu Star Wars trực tiếp từ API.

• Mở rộng cơ sở kiến thức
  Nâng cao cơ sở kiến thức AI với thông tin mới nhất về nhân vật, hành tinh và phương tiện từ vũ trụ Star Wars.

• Trình diễn đoạn mã mẫu
  Máy chủ đóng vai trò là một triển khai tham chiếu về cách xây dựng máy chủ MCP kết nối với REST API, giúp lập trình viên học về các khái niệm MCP.

Cách thiết lập

Windsurf

1. Đảm bảo Node.js đã được cài đặt trên hệ thống của bạn.
2. Tìm tệp cấu hình Windsurf của bạn.
3. Thêm Máy chủ Star Wars MCP bằng đoạn JSON sau:

   {
     "mcpServers": {
       "starwars-mcp": {
         "command": "npx",
         "args": ["@johnpapa/mcp-starwars@latest"]
       }
     }
   }
   

4. Lưu cấu hình và khởi động lại Windsurf.
5. Kiểm tra máy chủ đang chạy bằng cách xem log của Windsurf.

Claude

1. Cài đặt Node.js nếu chưa có.
2. Mở phần cấu hình tích hợp Claude.
3. Thêm vào phần MCP servers đoạn sau:

   {
     "mcpServers": {
       "starwars-mcp": {
         "command": "npx",
         "args": ["@johnpapa/mcp-starwars@latest"]
       }
     }
   }
   

4. Lưu và tải lại Claude.
5. Xác nhận máy chủ hoạt động qua giao diện Claude.

Cursor

1. Đảm bảo Node.js đã được thiết lập.
2. Truy cập tệp cấu hình Cursor.
3. Thêm mục Máy chủ Star Wars MCP:

   {
     "mcpServers": {
       "starwars-mcp": {
         "command": "npx",
         "args": ["@johnpapa/mcp-starwars@latest"]
       }
     }
   }
   

4. Khởi động lại Cursor để áp dụng thay đổi.
5. Xác thực máy chủ MCP có thể truy cập.

Cline

1. Thiết lập Node.js trong môi trường của bạn.
2. Mở phần cài đặt MCP servers của Cline.
3. Đăng ký Máy chủ Star Wars MCP:

   {
     "mcpServers": {
       "starwars-mcp": {
         "command": "npx",
         "args": ["@johnpapa/mcp-starwars@latest"]
       }
     }
   }
   

4. Lưu cấu hình và khởi động lại Cline.
5. Kiểm tra trang trạng thái của Cline để kết nối máy chủ.

Bảo mật API Key

Nếu máy chủ hoặc SWAPI yêu cầu API key hoặc biến môi trường, sử dụng định dạng sau:

{
  "mcpServers": {
    "starwars-mcp": {
      "command": "npx",
      "args": ["@johnpapa/mcp-starwars@latest"],
      "env": {
        "SWAPI_API_KEY": "${SWAPI_API_KEY}"
      },
      "inputs": {
        "apiKey": "${SWAPI_API_KEY}"
      }
    }
  }
}

Lưu ý: API SWAPI là công khai và thường không yêu cầu API key, nhưng mẫu này được cung cấp để tuân thủ thực hành tốt nhất.

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

Sử dụng MCP trong FlowHunt

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

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

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

Sau khi cấu hình, tác nhân AI đã có thể sử dụng MCP này như một công cụ với đầy đủ chức năng của nó. Hãy nhớ đổi “starwars-mcp” thành tên thật của máy chủ MCP của bạn và thay URL bằng địa chỉ máy chủ MCP của bạn.

Tổng quan

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

Star Wars MCP Server là một bản tham chiếu tập trung kết nối tác nhân AI với Star Wars API thông qua MCP. Dù minh họa tốt về khái niệm, nó thiếu tài liệu về resource, mẫu prompt và tool - những yếu tố quan trọng cho môi trường sản xuất. Là ví dụ giáo dục, nó rõ ràng và sử dụng giấy phép MIT, nhưng tính ứng dụng bị giới hạn do thiếu các tính năng MCP nâng cao.

Điểm MCP

Tổng thể, máy chủ MCP này được đánh giá 4/10, là điểm khởi đầu tốt nhưng thiếu chiều sâu và tài liệu của một tích hợp MCP đầy đủ tính năng.