Blog

Cách Biến API Thành Máy Chủ MCP

Ashley Goolam

Ashley Goolam

25 tháng 7 2025

Cách Biến API Thành Máy Chủ MCP

Bạn đã bao giờ ước API của mình có thể trò chuyện với các tác nhân AI như Claude hoặc Cursor, biến các điểm cuối của bạn thành các công cụ thông minh, đàm thoại chưa? Vâng, hãy sẵn sàng, vì chúng ta sẽ đi sâu vào cách biến API của bạn thành máy chủ MCP bằng cách sử dụng Stainless và một đặc tả OpenAPI. Hướng dẫn đàm thoại này sẽ hướng dẫn bạn qua quy trình, từ thiết lập đến triển khai, kèm theo một bài kiểm tra để chứng minh nó hoạt động. Chúng ta sẽ sử dụng Giao thức Ngữ cảnh Mô hình (MCP) để làm cho API của bạn thân thiện với AI, tất cả theo một cách thú vị, dễ tiếp cận. Hãy bắt đầu!

💡
Bạn muốn một công cụ kiểm thử API tuyệt vời tạo ra 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 để nhóm 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!
nút

Máy chủ MCP là gì và tại sao bạn nên quan tâm?

Giao thức Ngữ cảnh Mô hình (MCP) giống như một cái bắt tay chung cho các hệ thống AI. Đây là một tiêu chuẩn dựa trên JSON-RPC cho phép các ứng dụng khách AI (như Claude Desktop, Cursor hoặc VS Code Copilot) tương tác với API của bạn bằng ngôn ngữ tự nhiên hoặc các lời nhắc có thể lập trình. Một máy chủ MCP hoạt động như một cầu nối, dịch các điểm cuối của API của bạn thành các công cụ mà các tác nhân AI có thể hiểu và sử dụng.

Tại sao phải biến API của bạn thành máy chủ MCP? Đó là một yếu tố thay đổi cuộc chơi:

Cho dù bạn đang xây dựng một nền tảng thanh toán, một API nội dung hay một dịch vụ tùy chỉnh, việc biến API của bạn thành một máy chủ MCP sẽ làm cho nó thông minh hơn và dễ tiếp cận hơn.

Stainless phù hợp như thế nào?

Stainless là người bạn tốt nhất của nhà phát triển để tạo SDK và giờ đây là máy chủ MCP từ các đặc tả OpenAPI. Tính năng tạo máy chủ MCP thử nghiệm của nó lấy định nghĩa OpenAPI của bạn và xuất ra một gói con TypeScript sẵn sàng hoạt động như một máy chủ MCP. Điều này có nghĩa là các điểm cuối của API của bạn trở thành công cụ có thể truy cập bằng AI mà bạn không cần phải tốn công sức. Hãy xem cách thực hiện!

trang web chính thức của Stainless

Biến API của bạn thành máy chủ MCP với Stainless

Điều kiện tiên quyết

Trước khi chúng ta đi sâu vào, hãy đảm bảo bạn có:

Bước 1: Kiểm thử Đặc tả OpenAPI của bạn với Apidog

Trước hoặc thậm chí sau khi biến đặc tả OpenAPI của bạn thành máy chủ MCP, sẽ rất tuyệt nếu kiểm thử nó. Và đó là lúc Apidog trở nên hữu ích! Nền tảng trực quan của Apidog cho phép bạn nhập và kiểm thử đặc tả OpenAPI của mình để đảm bảo các điểm cuối của API đã sẵn sàng cho việc tích hợp MCP. Đây là cách thực hiện:

  1. Truy cập Apidog và Đăng ký hoặc Đăng nhập:
nút

2. Tạo Dự án mới và Nhập Đặc tả OpenAPI của bạn:

tải lên tệp

3. Cấu hình cài đặt API:

nhập thành công

4. Thêm điểm cuối và Kiểm thử:

xây dựng API của bạn

Kiểm thử với Apidog đảm bảo đặc tả OpenAPI của bạn vững chắc, giúp quá trình tạo MCP của Stainless mượt mà hơn và máy chủ MCP của bạn đáng tin cậy hơn.

Bước 2: Thiết lập Dự án Stainless với TypeScript

Tạo một Dự án Stainless:

tạo một dự án mới

Bật tạo máy chủ MCP:

thêm mcp sdk

Bước 3: Cấu hình tạo máy chủ MCP

Trong cài đặt dự án Stainless của bạn, cấu hình các tùy chọn máy chủ MCP. Tạo hoặc chỉnh sửa tệp cấu hình (ví dụ: stainless.yaml) với:

targets:
  typescript:
    package_name: my-org-name
    production_repo: null
    publish:
      npm: false
    options:
      mcp_server:
        package_name: my-org-name-mcp
        enable_all_resources: true

Điều này cho Stainless biết để tạo một gói con máy chủ MCP triển khai các điểm cuối của API của bạn dưới dạng công cụ có thể truy cập bằng AI.

Bước 4: Tùy chỉnh hiển thị điểm cuối và mô tả công cụ

Theo mặc định, tất cả các điểm cuối trong đặc tả OpenAPI của bạn trở thành công cụ MCP. Để tùy chỉnh:

  1. Chọn các điểm cuối cụ thể:
resources:
  users:
    mcp: true
    methods:
      create:
        mcp: true
  orders:
    methods:
      create:
        mcp: true
        endpoint: post /v1/orders

2. Tinh chỉnh siêu dữ liệu công cụ:

resources:
  users:
    methods:
      create:
        mcp:
          tool_name: create_user
          description: Creates a new user profile with name and email.

Điều này đảm bảo máy chủ MCP của bạn chỉ hiển thị các điểm cuối bạn muốn, với các mô tả rõ ràng, thân thiện với AI.

Bước 5: Xử lý các API lớn bằng cách lọc công cụ và công cụ động

Đối với các API có nhiều điểm cuối (>50), việc hiển thị từng điểm cuối dưới dạng một công cụ riêng biệt có thể làm quá tải cửa sổ ngữ cảnh của AI. Sử dụng các chiến lược sau:

  1. Lọc công cụ:
npx -y my-org-mcp --resource=users

2. Chế độ công cụ động:

npx -y my-org-mcp --tools=dynamic

Công cụ động cho phép AI khám phá và gọi các điểm cuối một cách linh hoạt, giảm tải ngữ cảnh.

Bước 6: Xây dựng và Xuất bản Máy chủ MCP của bạn

Xây dựng Máy chủ MCP:

Xuất bản lên npm:

npm publish
xuất bản

Bước 7: Cài đặt và cấu hình cho ứng dụng khách MCP

Sau khi xuất bản, cài đặt gói máy chủ MCP của bạn cục bộ hoặc từ xa để sử dụng với các ứng dụng khách AI. Đối với Claude Desktop:

  1. Cài đặt gói:
npm install my-org-name-mcp

2. Cấu hình Claude Desktop:

chỉnh sửa cấu hình claude
{
  "mcpServers": {
    "my_org_api": {
      "command": "npx",
      "args": ["-y", "my-org-mcp"],
      "env": {
        "MY_API_KEY": "123e4567-e89b-12d3-a456-426614174000"
      }
    }
  }
}

3. Các ứng dụng khách khác:

công cụ và tích hợp của cursor

Bước 8: Kiểm thử Máy chủ MCP của bạn

Hãy kiểm thử máy chủ MCP của bạn! Trong Claude Desktop (hoặc một ứng dụng khách MCP khác), hãy thử lời nhắc này:

alex@example.com

Nếu API của bạn có một điểm cuối POST /users (như được định nghĩa trong đặc tả OpenAPI của bạn), máy chủ MCP sẽ dịch lời nhắc này thành một lệnh gọi API, tạo người dùng và trả về một phản hồi như:

User created: { "name": "Alex", "email": "alex@example.com", "id": "123" }

Điều này xác nhận máy chủ MCP của bạn đang hoạt động và sẵn sàng cho các tương tác do AI điều khiển.

Mẹo khắc phục sự cố

Các thực hành tốt nhất cho máy chủ MCP

Kết luận

Và đó là tất cả! Bạn vừa học cách biến API của mình thành máy chủ MCP bằng cách sử dụng Stainless, biến đặc tả OpenAPI của bạn thành một cỗ máy mạnh mẽ sẵn sàng cho AI. Từ việc cấu hình các điểm cuối đến kiểm thử bằng lời nhắc tạo người dùng, hướng dẫn này giúp bạn dễ dàng kết nối API của mình với các tác nhân AI như Claude hoặc Cursor. Cho dù bạn đang nâng cấp một dự án nhỏ hay mở rộng một API sản xuất, máy chủ MCP là tấm vé giúp bạn có được các tích hợp thông minh hơn, đàm thoại hơn.

Sẵn sàng thử chưa? Lấy đặc tả OpenAPI của bạn, khởi động Stainless và để API của bạn tỏa sáng trong thế giới AI.

💡
Bạn muốn một công cụ kiểm thử API tuyệt vời tạo ra 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 để nhóm 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!
nút

Thực hành thiết kế API trong Apidog

Khám phá cách dễ dàng hơn để xây dựng và sử dụng API

Đăng ký miễn phíTải xuống