YepCode MCP Server

chính thức

Thực thi bất kỳ mã nào do LLM tạo ra trong môi trường sandbox an toàn và có khả năng mở rộng của YepCode và tạo các công cụ MCP của riêng bạn bằng JavaScript hoặc Python, với hỗ trợ đầy đủ cho các gói NPM và PyPI

GitHub
43

Tài liệu

YepCode MCP Server Preview

NPM version NPM Downloads GitHub Workflow Status

Trust Score smithery badge

Máy chủ YepCode MCP là gì?

Một máy chủ MCP (Model Context Protocol) cho phép các nền tảng AI tương tác với cơ sở hạ tầng của YepCode. Chạy các tập lệnh do LLM tạo ra và biến các quy trình YepCode của bạn thành các công cụ mạnh mẽ mà trợ lý AI có thể sử dụng trực tiếp. YepCode là môi trường hoàn hảo để xây dựng một máy chủ công cụ MCP động: hiển thị mỗi quy trình như một công cụ (với OAuth, mã thông báo API hoặc thông tin xác thực của bạn), xác định các tham số của mỗi công cụ bằng JSON Schema để có toàn bộ sự linh hoạt, và triển khai các công cụ bằng Python hoặc Node.js—tất cả trong một máy chủ kết hợp nhiều ngôn ngữ.

Tại sao nên dùng Máy chủ YepCode MCP?

  • Tích hợp AI liền mạch: Chuyển đổi các quy trình YepCode thành các công cụ sẵn sàng cho AI mà không cần cấu hình
  • Kiểm soát quy trình thời gian thực: Cho phép tương tác trực tiếp giữa các hệ thống AI và quy trình làm việc của bạn
  • Bảo mật cấp doanh nghiệp: Thực thi mã trong các môi trường cô lập, sẵn sàng cho sản xuất của YepCode
  • Tương thích toàn cầu: Tích hợp với bất kỳ nền tảng AI nào hỗ trợ Model Context Protocol

YepCode: Môi trường hoàn hảo cho một Máy chủ Công cụ MCP Động

YepCode được xây dựng để trở thành nền tảng lý tưởng để chạy một máy chủ công cụ MCP động:

  • Một quy trình, một công cụ: Mỗi quy trình YepCode có thể được hiển thị như một công cụ MCP. Gắn thẻ các quy trình của bạn (ví dụ: mcp-tool, core, automation) và chúng sẽ trở thành các công cụ mà trợ lý AI có thể gọi. Bạn có thể bảo mật quyền truy cập bằng OAuth, mã thông báo API hoặc thông tin xác thực YepCode hiện có của bạn—mỗi công cụ chạy trong không gian làm việc của bạn với cùng một mô hình bảo mật.

  • Toàn quyền kiểm soát các tham số công cụ: Mỗi công cụ có thể xác định lược đồ tham số của riêng nó dưới dạng JSON Schema. Bạn có toàn bộ sự linh hoạt để mô tả các đầu vào (kiểu, mô tả, trường bắt buộc, enum, giá trị mặc định, v.v.), để AI nhận được siêu dữ liệu phong phú và có thể gọi các công cụ của bạn một cách chính xác.

  • Triển khai công cụ đa ngôn ngữ: Triển khai các công cụ bằng Python hoặc Node.js (hoặc cả hai). Cùng một máy chủ MCP có thể hiển thị các công cụ được hỗ trợ bởi các thời gian chạy khác nhau—hãy nghĩ về nó như một máy chủ MCP kết hợp các triển khai trên nhiều ngôn ngữ.

Để có tài liệu đầy đủ, hãy xem tài liệu Máy chủ YepCode MCP.

Cài đặt

Gói này cho phép bạn chạy máy chủ YepCode MCP cục bộ hoặc trong cơ sở hạ tầng của riêng bạn (NPX, Docker hoặc triển khai tùy chỉnh). Tích hợp nó với các nền tảng AI như Cursor hoặc Claude Desktop.

Mẹo: Từ tài khoản YepCode của bạn, bạn cũng có quyền truy cập vào một máy chủ MCP được lưu trữ không yêu cầu cài đặt cục bộ. URL kết nối luôn là: https://cloud.yepcode.io/mcp

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

Lấy thông tin xác thực API YepCode của bạn:

  1. Đăng ký YepCode Cloud
  2. Truy cập Settings > API credentials để tạo một mã thông báo API mới.

Sử dụng NPX

Đảm bảo bạn đã cài đặt Node.js (phiên bản 18 trở lên) và sử dụng cấu hình tương tự như sau:

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yepcode/mcp-server"],
      "env": {
        "YEPCODE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Sử dụng Docker

  1. Xây dựng image container:
docker build -t yepcode/mcp-server .
  1. Sử dụng cấu hình tương tự như sau:
{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "-e",
        "YEPCODE_API_TOKEN=your_api_token_here",
        "yepcode/mcp-server"
      ]
    }
  }
}

Gỡ lỗi

Việc gỡ lỗi các máy chủ MCP có thể khó khăn vì chúng giao tiếp qua stdio. Để làm cho việc này dễ dàng hơn, chúng tôi khuyên bạn nên sử dụng MCP Inspector, bạn có thể chạy bằng lệnh sau:

npm run inspector

Điều này sẽ khởi động một máy chủ nơi bạn có thể truy cập các công cụ gỡ lỗi trực tiếp trong trình duyệt của mình.

Tham khảo Công cụ YepCode MCP

Máy chủ MCP cung cấp một số công cụ để tương tác với cơ sở hạ tầng của YepCode:

Thực thi Mã

run_code

Thực thi mã trong môi trường an toàn của YepCode.

// Input
{
  code: string;                          // The code to execute
  options?: {
    language?: string;                   // Programming language (default: 'javascript')
    comment?: string;                    // Execution context
    settings?: Record<string, unknown>;  // Runtime settings
  }
}

// Response
{
  returnValue?: unknown;                 // Execution result
  logs?: string[];                       // Console output
  error?: string;                        // Error message if execution failed
}
Tùy chọn MCP

Máy chủ YepCode MCP hỗ trợ các tùy chọn sau:

  • runCodeCleanup: Bỏ qua việc dọn dẹp run_code. Theo mặc định, mã nguồn của quy trình run_code sẽ bị xóa sau khi thực thi. Nếu bạn muốn giữ lại cho mục đích kiểm toán, bạn có thể sử dụng tùy chọn này.
  • skipCodingRules: Bỏ qua việc bao gồm các quy tắc mã hóa trong định nghĩa công cụ run_code. Theo mặc định, các quy tắc mã hóa JavaScript và Python từ tài liệu YepCode được bao gồm trong lược đồ công cụ để hướng dẫn mã do AI tạo ra. Nếu bạn muốn bỏ qua điều này để khởi tạo công cụ nhanh hơn hoặc định nghĩa công cụ nhỏ hơn, bạn có thể sử dụng tùy chọn này.

Các tùy chọn có thể được truyền dưới dạng danh sách phân tách bằng dấu phẩy trong biến môi trường YEPCODE_MCP_OPTIONS.

Lựa chọn Công cụ

Bạn có thể kiểm soát những công cụ nào được kích hoạt bằng cách đặt biến môi trường YEPCODE_MCP_TOOLS với danh sách phân tách bằng dấu phẩy gồm các danh mục công cụ và thẻ quy trình:

Danh mục công cụ tích hợp sẵn:

  • run_code: Kích hoạt công cụ thực thi mã
  • yc_api: Kích hoạt tất cả các công cụ quản lý API cơ bản (quy trình, lịch trình, biến, lưu trữ, thực thi, mô-đun)
  • yc_api_full: Kích hoạt tất cả các công cụ quản lý API bao gồm các công cụ liên quan đến phiên bản (mở rộng yc_api với các công cụ quản lý phiên bản quy trình và mô-đun bổ sung)
  • bất kỳ tên công cụ API cụ thể nào (ví dụ: execute_process_sync, get_execution,...)

Thẻ quy trình:

  • Bất kỳ thẻ nào được sử dụng trong các quy trình YepCode của bạn (ví dụ: mcp-tool, core, automation, v.v.)
  • Khi bạn chỉ định một thẻ quy trình, tất cả các quy trình có thẻ đó sẽ được hiển thị dưới dạng các công cụ MCP riêng lẻ
  • Các công cụ quy trình sẽ được đặt tên bằng slug quy trình (hoặc có tiền tố yc_ và ID quy trình nếu tên dài hơn 60 ký tự)

Nếu không được chỉ định, tất cả các công cụ tích hợp sẵn được kích hoạt theo mặc định, nhưng không có công cụ quy trình nào sẽ được hiển thị.

// NPX configuration with options
{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yepcode/mcp-server"],
      "env": {
        "YEPCODE_API_TOKEN": "your_api_token_here",
        "YEPCODE_MCP_OPTIONS": "runCodeCleanup,skipCodingRules",
        "YEPCODE_MCP_TOOLS": "run_code,yc_api,mcp-tool,core"
      }
    }
  }
}

Các kịch bản ví dụ:

  • YEPCODE_MCP_TOOLS=run_code,yc_api - Kích hoạt công cụ thực thi mã tích hợp và các công cụ quản lý API cơ bản
  • YEPCODE_MCP_TOOLS=run_code,yc_api_full - Kích hoạt công cụ thực thi mã tích hợp và tất cả các công cụ quản lý API (bao gồm quản lý phiên bản)
  • YEPCODE_MCP_TOOLS=core,automation - Chỉ hiển thị các quy trình được gắn thẻ "core" hoặc "automation" dưới dạng công cụ
  • YEPCODE_MCP_TOOLS=run_code,yc_api,core - Kích hoạt các công cụ tích hợp cộng với tất cả các quy trình được gắn thẻ "core"

Quản lý Môi trường

set_env_var

Đặt một biến môi trường trong không gian làm việc YepCode.

// Input
{
  key: string;                           // Variable name
  value: string;                         // Variable value
  isSensitive?: boolean;                 // Whether to mask the value in logs (default: true)
}

remove_env_var

Xóa một biến môi trường khỏi không gian làm việc YepCode.

// Input
{
  key: string;                           // Name of the variable to remove
}

Quản lý Lưu trữ

YepCode cung cấp một hệ thống lưu trữ tích hợp cho phép bạn tải lên, liệt kê, tải xuống và xóa tệp. Những tệp này có thể được truy cập từ các lần thực thi mã của bạn bằng các phương thức trợ giúp yepcode.storage.

list_files

Liệt kê tất cả các tệp trong bộ lưu trữ YepCode của bạn.

// Input
{
  prefix?: string;                       // Optional prefix to filter files
}

// Response
{
  files: Array<{
    filename: string;                    // File name or path
    size: number;                        // File size in bytes
    lastModified: string;                // Last modification date
  }>;
}

upload_file

Tải một tệp lên bộ lưu trữ YepCode.

// Input
{
  filename: string;                      // File path (e.g., 'file.txt' or 'folder/file.txt')
  content: string | {                   // File content
    data: string;                        // Base64 encoded content for binary files
    encoding: "base64";
  };
}

// Response
{
  success: boolean;                      // Upload success status
  filename: string;                      // Uploaded file path
}

download_file

Tải xuống một tệp từ bộ lưu trữ YepCode.

// Input
{
  filename: string;                      // File path to download
}

// Response
{
  filename: string;                      // File path
  content: string;                       // File content (base64 for binary files)
  encoding?: string;                     // Encoding type if binary
}

delete_file

Xóa một tệp khỏi bộ lưu trữ YepCode.

// Input
{
  filename: string;                      // File path to delete
}

// Response
{
  success: boolean;                      // Deletion success status
  filename: string;                      // Deleted file path
}

Thực thi Quy trình

Máy chủ MCP có thể hiển thị các Quy trình YepCode của bạn dưới dạng các công cụ MCP riêng lẻ, làm cho chúng có thể truy cập trực tiếp bởi các trợ lý AI. Tính năng này được kích hoạt bằng cách chỉ định các thẻ quy trình trong biến môi trường YEPCODE_MCP_TOOLS.

Cách thức hoạt động:

  1. Gắn thẻ các quy trình YepCode của bạn với bất kỳ thẻ nào (ví dụ: core, api, automation, mcp-tool, v.v.)
  2. Thêm các thẻ đó vào biến môi trường YEPCODE_MCP_TOOLS
  3. Tất cả các quy trình có thẻ được chỉ định sẽ được hiển thị dưới dạng các công cụ MCP riêng lẻ

Sẽ có một công cụ cho mỗi quy trình được hiển thị, được đặt tên bằng slug quy trình (hoặc có tiền tố yc_ và ID quy trình nếu tên công cụ dài hơn 60 ký tự).

Để biết thêm thông tin về thẻ quy trình, hãy xem tài liệu thẻ quy trình của chúng tôi.

<process_slug>

// Input
{
  parameters?: any;                      // This should match the input parameters specified in the process
  options?: {
    tag?: string;                        // Process version to execute
    comment?: string;                    // Execution context
  };
  synchronousExecution?: boolean;        // Whether to wait for completion (default: true)
}

// Response (synchronous execution)
{
  executionId: string;                   // Unique execution identifier
  logs: string[];                        // Process execution logs
  returnValue?: unknown;                 // Process output
  error?: string;                        // Error message if execution failed
}

// Response (asynchronous execution)
{
  executionId: string;                   // Unique execution identifier
}

Công cụ Quản lý API

Các danh mục công cụ quản lý API (yc_api và yc_api_full) cung cấp quyền truy cập API toàn diện để quản lý tất cả các khía cạnh của không gian làm việc YepCode của bạn:

Công cụ API cơ bản (yc_api): Thẻ yc_api kích hoạt các công cụ quản lý API tiêu chuẩn cho các hoạt động cốt lõi trên không gian làm việc của bạn.

Công cụ API mở rộng (yc_api_full): Thẻ yc_api_full bao gồm mọi thứ từ yc_api cộng với các công cụ bổ sung để quản lý phiên bản quy trình và mô-đun.

Quản lý Quy trình:

  • get_processes - Liệt kê các quy trình với bộ lọc tùy chọn
  • create_process - Tạo quy trình mới với mã nguồn
  • get_process - Lấy chi tiết quy trình
  • update_process - Cập nhật một quy trình hiện có
  • delete_process - Xóa một quy trình
  • get_process_versions - Lấy các phiên bản quy trình (yêu cầu yc_api_full)
  • execute_process_async - Thực thi một quy trình không đồng bộ
  • execute_process_sync - Thực thi một quy trình đồng bộ
  • schedule_process - Lên lịch một quy trình để chạy tự động

Quản lý Lịch trình:

  • get_schedules - Liệt kê các quy trình đã lên lịch
  • get_schedule - Lấy chi tiết lịch trình
  • pause_schedule - Tạm dừng một quy trình đã lên lịch
  • resume_schedule - Tiếp tục một lịch trình đã tạm dừng
  • delete_schedule - Xóa một lịch trình
  • update_schedule - Cập nhật một quy trình đã lên lịch

Quản lý Biến:

  • get_variables - Liệt kê các biến nhóm
  • create_variable - Tạo một biến mới
  • update_variable - Cập nhật một biến hiện có
  • delete_variable - Xóa một biến

Quản lý Lưu trữ:

  • get_storage_objects - Liệt kê các đối tượng lưu trữ
  • upload_storage_object - Tải một tệp lên bộ lưu trữ
  • download_storage_object - Tải xuống một tệp từ bộ lưu trữ
  • delete_storage_object - Xóa một tệp khỏi bộ lưu trữ

Quản lý Thực thi:

  • get_executions - Liệt kê các lần thực thi với bộ lọc tùy chọn
  • get_execution - Lấy chi tiết thực thi từ API
  • kill_execution - Dừng một lần thực thi đang chạy
  • rerun_execution - Chạy lại một lần thực thi trước đó
  • get_execution_logs - Lấy nhật ký thực thi

Quản lý Mô-đun:

  • get_modules - Liệt kê các mô-đun thư viện tập lệnh
  • create_module - Tạo một mô-đun mới
  • get_module - Lấy chi tiết mô-đun
  • delete_module - Xóa một mô-đun
  • get_module_versions - Lấy các phiên bản mô-đun (yêu cầu yc_api_full)
  • get_module_version - Lấy một phiên bản mô-đun cụ thể (yêu cầu yc_api_full)
  • delete_module_version - Xóa một phiên bản mô-đun (yêu cầu yc_api_full)
  • get_module_aliases - Lấy bí danh phiên bản mô-đun (yêu cầu yc_api_full)

Giấy phép

Dự án này được cấp phép theo Giấy phép MIT - xem tệp LICENSE để biết chi tiết.