Bất kỳ Máy Chủ MCP OpenAPI nào

Máy Chủ MCP “Any OpenAPI” làm gì?

Máy Chủ MCP “Any OpenAPI” là một công cụ được thiết kế để kết nối các trợ lý AI—như Claude—với bất kỳ API ngoài nào có tài liệu OpenAPI (Swagger). Nó cho phép tìm kiếm ngữ nghĩa trong các tài liệu OpenAPI lớn, chia nhỏ endpoint thông minh để phát hiện và tương tác nhanh chóng. Nhờ đó, client AI có thể tìm kiếm endpoint API phù hợp qua truy vấn ngôn ngữ tự nhiên (ví dụ: “liệt kê sản phẩm”), lấy tài liệu đầy đủ cho endpoint ngay lập tức và thực thi yêu cầu API trực tiếp từ máy chủ. Máy chủ này lý tưởng để tích hợp API riêng hoặc lớn vào quy trình AI, đơn giản hóa các thao tác như truy vấn cơ sở dữ liệu hoặc tích hợp API tùy chỉnh mà không cần cập nhật thủ công thường xuyên.

Danh sách Prompt

Không có mẫu prompt cụ thể nào được đề cập trong tài liệu hoặc mã nguồn hiện có.

Danh sách Tài nguyên

Không có tài nguyên MCP cụ thể nào được liệt kê hoặc mô tả trong tài liệu hoặc mã nguồn hiện có.

Danh sách Công cụ

• custom_api_request_schema
  Khám phá endpoint API phù hợp bằng cách thực hiện tìm kiếm ngữ nghĩa qua tài liệu OpenAPI. Công cụ này xuất tài liệu endpoint thành từng phần dựa trên truy vấn ngôn ngữ tự nhiên.
• custom_make_request
  Thực thi một yêu cầu API đối với endpoint đã chọn. Cho phép trợ lý AI tương tác trực tiếp với API, gửi yêu cầu và nhận phản hồi.

Trường hợp sử dụng của Máy Chủ MCP này

• Tích hợp API cho dịch vụ riêng
  Kết nối Claude hoặc trợ lý khác với API riêng bằng cách cung cấp URL JSON OpenAPI, cho phép tương tác an toàn và động với hệ thống nội bộ.
• Khám phá endpoint nhanh chóng
  Sử dụng tìm kiếm ngữ nghĩa trong bộ nhớ (FAISS và MiniLM-L3) để nhanh chóng tìm endpoint API phù hợp, kể cả trong tài liệu OpenAPI lớn và phức tạp.
• Tự động hóa thực thi yêu cầu API
  Cho phép client AI không chỉ khám phá mà còn thực thi yêu cầu API, giúp quy trình như liệt kê sản phẩm, quản lý đơn hàng hoặc tra cứu người dùng không cần công cụ bổ sung.
• Truy cập tài liệu API theo ngữ cảnh
  Lấy ngay tài liệu cụ thể cho endpoint, hỗ trợ phát hiện chi tiết tham số và sử dụng cho tự động hóa do AI điều khiển.
• Tích hợp với Claude Desktop hoặc client tương tự
  Thiết kế để hoạt động với client MCP của Claude, vượt qua giới hạn kích thước tài liệu và cho phép sử dụng thực tế API lớn cho ứng dụng AI trên desktop.

Cách thiết lập

Windsurf

1. Đảm bảo bạn đã cài đặt Node.js và Windsurf.
2. Tìm file cấu hình Windsurf của bạn.
3. Thêm entry @any-openapi/mcp-server@latest vào đối tượng mcpServers.
4. Cung cấp lệnh và các biến môi trường cần thiết (như OPENAPI_JSON_DOCS_URL).
5. Lưu và khởi động lại Windsurf, sau đó kiểm tra máy chủ đã xuất hiện như mong muốn.

Ví dụ JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Bảo mật API Key:

{
  "env": {
    "API_KEY": "${ANY_OPENAPI_API_KEY}"
  },
  "inputs": {
    "apiKey": "${ANY_OPENAPI_API_KEY}"
  }
}

Claude

1. Đảm bảo Claude hỗ trợ tích hợp máy chủ MCP.
2. Mở phần cài đặt hoặc cấu hình cho máy chủ MCP.
3. Thêm thông tin máy chủ với lệnh và biến môi trường.
4. Lưu thay đổi và khởi động lại Claude nếu cần.
5. Xác nhận máy chủ có thể được phát hiện và đang hoạt động.

Ví dụ JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Cursor

1. Cài đặt Cursor và điều hướng đến phần cấu hình máy chủ MCP.
2. Thêm entry máy chủ MCP mới sử dụng package @any-openapi/mcp-server@latest.
3. Thiết lập biến môi trường cho API của bạn.
4. Lưu cấu hình và khởi động lại Cursor.
5. Kiểm tra tích hợp bằng cách liệt kê các công cụ khả dụng.

Ví dụ JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Cline

1. Mở file cấu hình Cline của bạn.
2. Thêm cấu hình máy chủ MCP cho @any-openapi/mcp-server@latest.
3. Thiết lập các biến môi trường cần thiết.
4. Lưu và khởi động lại Cline.
5. Đảm bảo máy chủ xuất hiện trong danh sách máy chủ MCP hoạt động.

Ví dụ JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Bảo mật API Key:
Sử dụng biến môi trường như trên để tránh lộ thông tin nhạy cảm.

Cách dùng MCP này trong flows

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào luồng làm việc FlowHunt, hãy thêm thành phần MCP vào flow của bạn và kết nối với agent AI:

Nhấn 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:

{
  "any-openapi": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Khi đã cấu hình, agent AI có thể sử dụng MCP này như một công cụ với đầy đủ chức năng. Lưu ý thay “any-openapi” bằng tên thực tế của máy chủ MCP của bạn và thay thế URL bằng endpoint chính xác.

Tổng quan

Hỗ trợ Roots: Không được nêu trong tài liệu hoặc mã nguồn hiện có.

Dựa trên tài liệu đã cung cấp và bảng tổng kết trên, máy chủ MCP này tập trung, hiệu quả và phù hợp cho tích hợp API và khám phá endpoint động, nhưng chưa có tài liệu mẫu prompt/tài nguyên rõ ràng cũng như hướng dẫn sampling hay roots. Cách thiết lập và bảo mật rõ ràng, chuẩn hóa.

Nhận xét của chúng tôi

Máy chủ MCP này rất thực tiễn cho lập trình viên cần tích hợp API lớn hoặc riêng với trợ lý AI, đặc biệt là Claude. Giá trị sử dụng nổi bật ở khả năng khám phá endpoint ngữ nghĩa và thực thi API trực tiếp, tuy nhiên sẽ tốt hơn nếu có thêm tài liệu và định nghĩa tài nguyên. Tổng thể, đây là máy chủ tốt, tập trung, nhưng chưa phải ví dụ toàn diện về mọi tính năng MCP.

Đánh giá: 7/10

Điểm MCP