Klavis Strata MCP Server

chính thức

Một máy chủ MCP để các tác nhân AI sử dụng bất kỳ công cụ nào một cách đáng tin cậy ở mọi quy mô

Tài liệu

Strata

Một máy chủ MCP cho các tác nhân AI sử dụng công cụ một cách tiệm tiến ở mọi quy mô

Strata là gì?

Strata là một máy chủ MCP hướng dẫn các tác nhân AI sử dụng công cụ một cách đáng tin cậy ở mọi mức độ phức tạp, thay vì khiến chúng choáng ngợp với mọi thứ cùng một lúc, nó được thiết kế dựa trên cách con người tương tác với công cụ, giải quyết ba vấn đề lớn đang gây khó khăn cho các tác nhân AI hiện nay:

Quá tải công cụ: Quá nhiều công cụ khiến LLM bị tê liệt lựa chọn
Quá tải ngữ cảnh: Danh sách công cụ dài làm tăng số lượng token và chi phí
Khoảng trống phủ sóng: Hầu hết các máy chủ chỉ dừng ở 40~50 công cụ, giới hạn những gì bạn có thể xây dựng

Bạn có thể sử dụng Strata qua trang web, API, hoặc thậm chí mã nguồn mở trên dữ liệu của riêng bạn!

Video Hướng dẫn

Xem video hướng dẫn này để hiểu đầy đủ về cách Strata hoạt động:

Hướng dẫn Văn bản Hãy xem [cuộc trò chuyện Claude được chia sẻ](https://claude.ai/share/9b44a192-9f2d-46e2-a875-ef905c457070) này để thấy Strata hoạt động!

1. Khám phá Danh mục hoặc Hành động của Máy chủ

discover_server_categories_or_actions - tìm các danh mục hoặc hành động liên quan dựa trên ý định của người dùng. Không phải tìm kiếm ngữ nghĩa!

**Mô tả**: **ĐIỂM KHỞI ĐẦU ƯU TIÊN**. Khám phá các danh mục hoặc hành động có sẵn dựa trên truy vấn của người dùng. Hãy thử công cụ này trước khi khám phá những hành động nào có sẵn trên các máy chủ. Đây là điểm vào chính để khám phá các hành động có sẵn và nên được sử dụng trước các phương pháp tìm kiếm khác. Đầu ra sẽ là danh sách các máy chủ với mức độ chi tiết và chi tiết.

Nếu mức độ chi tiết là 'categories_only', chi tiết sẽ chỉ là danh sách tên danh mục. Bước tiếp theo nên sử dụng công cụ get_category_actions để lấy các hành động cho các danh mục.

Nếu mức độ chi tiết là 'full_details', chi tiết sẽ là danh sách tên danh mục kèm theo chi tiết hành động của chúng. Điều này xảy ra khi máy chủ chỉ có một vài hành động. Bước tiếp theo nên sử dụng công cụ execute_action để thực thi các hành động.

Nếu mức độ chi tiết là 'categories_and_actions', chi tiết sẽ là danh sách tên danh mục và tên hành động. Điều này xảy ra khi sử dụng các công cụ bên ngoài. Bước tiếp theo nên sử dụng công cụ get_action_details để lấy chi tiết của các hành động.

Tham số:

user_query (chuỗi, bắt buộc): Truy vấn ngôn ngữ tự nhiên của người dùng để lọc kết quả.
server_names (mảng, bắt buộc): Danh sách tên máy chủ để khám phá danh mục hoặc hành động.

2. Lấy Hành động của Danh mục

get_category_actions - truy xuất tất cả tên hành động trong các danh mục được chỉ định.

**Mô tả**: Nhận tổng quan toàn diện về các hành động API có sẵn trong các danh mục cụ thể. Sử dụng công cụ này nếu bạn muốn khám phá những hành động nào có sẵn trong các danh mục dịch vụ cụ thể hoặc có cái nhìn chi tiết về khả năng của danh mục. \*\* Quan trọng \*\*: Chỉ nên được gọi sau khi bạn nhận được các danh mục máy chủ từ công cụ discover_server_categories.

Tham số:

category_names (mảng, bắt buộc): Danh sách các danh mục để lấy hành động

3. Lấy Chi tiết Hành động

get_action_details - lấy lược đồ đầy đủ và tham số cho một hành động cụ thể.

**Mô tả**: Nhận thông tin chi tiết về một hành động cụ thể, bao gồm các tham số bắt buộc và tùy chọn. Phải cung cấp tên danh mục và tên hành động. \*\* Quan trọng \*\*: Chỉ nên được gọi sau khi bạn nhận được các danh mục máy chủ từ các lần gọi công cụ trước đó.

Tham số:

category_name (chuỗi, bắt buộc): Tên của danh mục
action_name (chuỗi, bắt buộc): Tên của hành động/thao tác trong danh mục

4. Thực thi Hành động

execute_action - chạy các hành động với tham số và nhận kết quả.

**Mô tả**: Thực thi một hành động cụ thể với các tham số được cung cấp. Phải cung cấp tên máy chủ, tên hành động và các tham số hành động. \*\* Quan trọng \*\*: Chỉ nên được gọi sau khi bạn nhận được chi tiết hành động từ công cụ get_action_details.

Tham số:

server_name (chuỗi, bắt buộc): Tên của máy chủ
category_name (chuỗi, bắt buộc): Tên của danh mục để thực thi hành động
action_name (chuỗi, bắt buộc): Tên của hành động/thao tác để thực thi
path_params (chuỗi, tùy chọn): Chuỗi JSON chứa các tham số đường dẫn cho hành động
query_params (chuỗi, tùy chọn): Chuỗi JSON chứa các tham số truy vấn cho hành động
body_schema (chuỗi, tùy chọn, mặc định: "{}"): Chuỗi JSON chứa phần thân yêu cầu cho các hành động
include_output_fields (mảng, tùy chọn): Tùy chọn nhưng được khuyến nghị mạnh mẽ khi bạn biết response_schema của hành động này từ các lần gọi công cụ trước đó: Mảng các đường dẫn trường để bao gồm trong phản hồi. Chỉ những trường này sẽ được trả về. Sử dụng ký hiệu dấu chấm cho các trường lồng nhau (ví dụ: "author.displayName").
maximum_output_characters (số nguyên, tùy chọn): Tùy chọn: Số ký tự tối đa để trả về trong phản hồi. Nếu phản hồi vượt quá giới hạn này, nó sẽ bị cắt bớt. Ưu tiên include_output_fields hơn cái này.

5. Tìm kiếm Tài liệu

search_documentation - tìm thông tin liên quan chỉ khi cần thiết.

**Mô tả**: **TÙY CHỌN THỨ HAI**: Chỉ sử dụng công cụ này khi discover_server_categories không cung cấp đủ chi tiết hoặc khi bạn cần tìm kiếm trong tài liệu của một máy chủ cụ thể. Tìm kiếm tài liệu hành động của máy chủ theo danh mục, thao tác, thẻ hoặc chức năng bằng cách khớp từ khóa. Đây không phải là tìm kiếm ngôn ngữ tự nhiên - nó khớp chính xác các từ khóa và cụm từ. Trả về các điểm cuối được xếp hạng theo mức độ liên quan. Sử dụng một vài từ khóa có mục tiêu để tìm các kết quả phù hợp nhất. Các mẫu phổ biến: tên danh mục ('projects', 'users', 'pipelines'), hành động ('create', 'delete', 'list', 'get'), hoặc kết hợp ('create user', 'list projects'). Thuật toán tìm kiếm sử dụng tính điểm thông minh để ngăn các trường mô tả dài dòng lấn át kết quả.

Tham số:

query (chuỗi, bắt buộc): Từ khóa tìm kiếm khớp với các thuật ngữ tài liệu API. Thực hành tốt nhất: (1) Sử dụng tên tài nguyên như 'users', 'projects', 'files', (2) Thêm hành động để chính xác như 'user create' hoặc 'project delete', (3) Tránh các từ đệm như 'how to', 'show me', 'all the' - tập trung vào các thuật ngữ cốt lõi xuất hiện trong tên và mô tả điểm cuối.
server_name (chuỗi, bắt buộc): Tên của máy chủ để tìm kiếm trong đó.
max_results (số nguyên, tùy chọn, mặc định: 10, tối thiểu: 1, tối đa: 50): Số lượng kết quả trả về. Mặc định: 10

6. Xử lý Lỗi Xác thực

handle_auth_failure - xử lý xác thực chỉ khi cần thiết.

**Mô tả**: Xử lý các lỗi xác thực xảy ra khi thực thi hành động. QUAN TRỌNG: Công cụ này CHỈ nên được gọi khi execute_action thất bại cụ thể do vấn đề xác thực (401 Unauthorized, thông tin đăng nhập không hợp lệ, token hết hạn, v.v.). KHÔNG gọi công cụ này để kiểm tra trạng thái xác thực hoặc cho bất kỳ mục đích nào khác. Cách sử dụng: (1) Khi execute_action trả về lỗi xác thực, hãy gọi công cụ này với 'get_auth_url' để nhận hướng dẫn xác thực. (2) Khi người dùng cung cấp dữ liệu xác thực sau một lỗi, hãy gọi công cụ này với 'save_auth_data' để lưu thông tin đăng nhập. KHÔNG BAO GIỜ gọi công cụ này nếu lỗi KHÔNG phải là lỗi xác thực (ví dụ: 404 Not Found, 500 Internal Server Error, v.v.).

Tham số:

server_name (chuỗi, bắt buộc): Tên của máy chủ bị lỗi xác thực trong quá trình execute_action
intention (chuỗi, bắt buộc, enum: ["get_auth_url", "save_auth_data"]): Sử dụng 'get_auth_url' khi execute_action thất bại với lỗi xác thực để nhận hướng dẫn xác thực. Sử dụng 'save_auth_data' khi người dùng cung cấp thông tin đăng nhập sau một lỗi xác thực.
auth_data (đối tượng, tùy chọn): Dữ liệu xác thực do người dùng cung cấp sau một lỗi xác thực (ví dụ: {"token": "...", "api_key": "..."}). Chỉ được sử dụng với ý định 'save_auth_data' khi giải quyết các lỗi xác thực.

Đánh giá

Strata mang lại kết quả thực sự:

Điểm chuẩn MCPMark: Đạt tỷ lệ pass@1 cao hơn +15.2% so với máy chủ GitHub chính thức và tỷ lệ pass@1 cao hơn +13.4% so với máy chủ Notion chính thức. (Nguồn)
Đánh giá của Con người: Đạt độ chính xác trên 83% trên các tập đánh giá hơn 2k truy vấn thực tế

Các bước Tiếp theo

Tạo máy chủ Strata đầu tiên của bạn trong vài phút Khám phá API Strata đầy đủ