Klavis Strata

官方

一個讓AI代理在任何規模下可靠使用任何工具的MCP伺服器

你可以用 Klavis Strata MCP 做什麼?

  • 探索相關動作 — 使用自然語言意圖,請助理透過 discover_server_categories_or_actions 在指定伺服器中尋找類別或動作。
  • 列出類別動作 — 在深入查看詳細資訊前,使用 get_category_actions 擷取特定類別中的所有動作名稱。
  • 檢視動作結構描述 — 使用類別和動作名稱,透過 get_action_details 取得特定動作的必要與選用參數。
  • 執行動作 — 透過 execute_action 使用路徑、查詢和本文參數執行動作,也可使用 include_output_fields 限制傳回的欄位。
  • 搜尋伺服器文件 — 當探索結果缺少詳細資訊時,使用 search_documentation 在伺服器文件中依關鍵字尋找端點。
  • 解決驗證失敗 — 發生驗證錯誤後,使用 handle_auth_failure 取得驗證指示或儲存憑證。

文件

Strata

為 AI 代理提供一個 MCP 伺服器,讓它們能以漸進方式使用工具,並適用於任何規模

Strata Hero - Progressive tool discovery for AI agents

什麼是 Strata?

Strata 是一個 MCP 伺服器,可引導 AI 代理可靠地使用工具,無論複雜度如何;它不會一次提供所有工具,造成資訊過載。Strata 的設計理念是模擬人類與工具互動的方式,解決當今困擾 AI 代理的三大問題:

  • 工具過載:工具太多會讓 LLM 難以抉擇
  • 上下文過載:冗長的工具清單會大幅增加 token 數量與成本
  • 涵蓋範圍不足:大多數伺服器僅支援 40~50 個工具,限制了可建置的功能

您可以透過我們的網站、API,或在自己的資料上使用開源版本!

影片教學

觀看此影片教學,完整了解 Strata 的運作方式:

Strata

文字教學

[!TIP]

查看這段分享的 Claude 對話,了解 Strata 的實際運作!

1. 探索伺服器類別或動作

discover_server_categories_or_actions - 根據使用者意圖尋找相關類別或動作。無須語意搜尋!

[accordion] 工具詳細資訊

說明:建議的起始點。根據使用者查詢探索可用的類別或動作。在探索伺服器提供哪些動作時,請先使用此工具。這是探索可用動作的主要入口,應在使用其他搜尋方法之前呼叫。輸出會列出伺服器、詳細程度及詳細資訊。

如果詳細程度為 'categories_only',詳細資訊將只列出類別名稱。下一步建議使用 get_category_actions 工具取得這些類別的動作。

如果詳細程度為 'full_details',詳細資訊將列出類別名稱及其動作詳細資訊。當伺服器只有少數動作時會採用此模式。下一步建議使用 execute_action 工具執行動作。

如果詳細程度為 'categories_and_actions',詳細資訊將列出類別名稱和動作名稱。使用外部工具時會採用此模式。下一步建議使用 get_action_details 工具取得動作詳細資訊。

參數:

  • user_query (string, required):用於篩選結果的自然語言使用者查詢。
  • server_names (array, required):要探索類別或動作的伺服器名稱清單。

2. 取得類別動作

get_category_actions - 取得指定類別中的所有動作名稱。

[accordion] 工具詳細資訊

說明:全面檢視特定類別中可用的 API 動作。若要探索特定服務類別中有哪些動作,或詳細了解類別功能,請使用此工具。** 重要 **:只有在透過 discover_server_categories 工具取得伺服器類別後,才能呼叫此工具。

參數:

  • category_names (array, required):要取得動作的類別清單

3. 取得動作詳細資訊

get_action_details - 取得特定動作的完整結構描述和參數。

[accordion] 工具詳細資訊

說明:取得特定動作的詳細資訊,包括必要和選用參數。必須提供類別名稱和動作名稱。** 重要 **:只有在先前的工具呼叫取得伺服器類別後,才能呼叫此工具。

參數:

  • category_name (string, required):類別名稱
  • action_name (string, required):類別中的動作/操作名稱

4. 執行動作

execute_action - 使用參數執行動作並取得結果。

[accordion] 工具詳細資訊

說明:使用提供的參數執行特定動作。必須提供伺服器名稱、動作名稱和動作參數。** 重要 **:只有在透過 get_action_details 工具取得動作詳細資訊後,才能呼叫此工具。

參數:

  • server_name (string, required):伺服器名稱
  • category_name (string, required):要執行動作的類別名稱
  • action_name (string, required):要執行的動作/操作名稱
  • path_params (string, optional):包含此動作路徑參數的 JSON 字串
  • query_params (string, optional):包含此動作查詢參數的 JSON 字串
  • body_schema (string, optional, default: "{}"):包含動作請求主體的 JSON 字串
  • include_output_fields (array, optional):選用,但若您已在先前的工具呼叫中取得此動作的 response_schema,強烈建議提供:要納入回應的欄位路徑陣列。巢狀欄位請使用點號表示法(例如 "author.displayName")。回應只會傳回這些欄位。
  • maximum_output_characters (integer, optional):選用:回應中要傳回的字元數上限。若回應超過此限制,將會截斷。建議優先使用 include_output_fields。

5. 搜尋文件

search_documentation - 僅在需要時尋找相關資訊。

[accordion] 工具詳細資訊

說明:次要選項:只有在 discover_server_categories 未提供足夠詳細資訊,或您需要搜尋特定伺服器的文件時,才使用此工具。使用關鍵字比對,依類別、操作、標籤或功能搜尋伺服器動作文件。這不是自然語言搜尋,而是比對完全相符的關鍵字和詞組。傳回依相關性排序的端點。使用少量精準關鍵字,找出最符合的結果。常見模式:類別名稱('projects'、'users'、'pipelines')、動作('create'、'delete'、'list'、'get'),或兩者組合('create user'、'list projects')。搜尋演算法採用智慧評分,避免冗長的說明欄位影響結果。

參數:

  • query (string, required):用於比對 API 文件術語的搜尋關鍵字。最佳做法:(1) 使用資源名稱,例如 'users'、'projects'、'files';(2) 加入動作以提高精確度,例如 'user create' 或 'project delete';(3) 避免使用 'how to'、'show me'、'all the' 等填充詞,聚焦於端點名稱和說明中出現的核心術語。
  • server_name (string, required):要搜尋的伺服器名稱。
  • max_results (integer, optional, default: 10, minimum: 1, maximum: 50):要傳回的結果數量。預設值:10

6. 處理驗證失敗

handle_auth_failure - 僅在需要時處理驗證問題。

[accordion] 工具詳細資訊

說明:處理執行動作時發生的驗證失敗。重要:只有在 execute_action 明確因驗證問題而失敗時(401 Unauthorized、憑證無效、權杖過期等),才能呼叫此工具。請勿使用此工具檢查驗證狀態或用於任何其他目的。使用方式:(1) 當 execute_action 傳回驗證錯誤時,使用 'get_auth_url' 呼叫此工具以取得驗證指示。(2) 使用者在失敗後提供驗證資料時,使用 'save_auth_data' 呼叫此工具以儲存憑證。如果失敗並非驗證失敗(例如 404 Not Found、500 Internal Server Error 等),絕不可呼叫此工具。

參數:

  • server_name (string, required):在 execute_action 期間驗證失敗的伺服器名稱
  • intention (string, required, enum: ["get_auth_url", "save_auth_data"]):當 execute_action 因驗證錯誤而失敗時,使用 'get_auth_url' 取得驗證指示。使用者在驗證失敗後提供驗證憑證時,使用 'save_auth_data'。
  • auth_data (object, optional):使用者在驗證失敗後提供的驗證資料(例如 {"token": "...", "api_key": "..."})。僅在處理驗證失敗時,搭配 'save_auth_data' 意圖使用。

評估

Strata 帶來實際成效:

  • MCPMark 基準測試:相較於官方 GitHub 伺服器,pass@1 成功率高出 +15.2%;相較於官方 Notion 伺服器,pass@1 成功率高出 +13.4%。(來源)
  • 人工評估:在超過 2k 個真實世界查詢的評估集中,準確率達 83%+

後續步驟

[card] 開始使用

幾分鐘內建立您的第一個 Strata 伺服器

[card] API 參考

探索完整的 Strata API

此文件使用開發者文件平台 Mintlify 建置並託管。