Klavis Strata MCP Server

官方

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

文件

Strata

一個 MCP 伺服器,讓 AI 代理在任何規模下逐步使用工具

<img src="https://mintcdn.com/klavisai/7Siw7A5JJSHURM5d/images/concepts/strata_hero.png?fit=max&auto=format&n=7Siw7A5JJSHURM5d&q=85&s=b581fdb821699a32b260d124789396bd" alt="Strata Hero - Progressive tool discovery for AI agents" className="w-full rounded-lg" style={{ maxWidth: '100%', height: 'auto' }} width="2533" height="496" data-path="images/concepts/strata_hero.png" />

什麼是 Strata?

Strata 是一個 MCP 伺服器,引導 AI 代理在任何複雜度下可靠地使用工具,而不是一次把所有東西塞給它們。它的設計理念是模擬人類與工具互動的方式,解決了當前困擾 AI 代理的三大問題:

  • 工具超載:太多工具導致 LLM 選擇癱瘓
  • 上下文超載:冗長的工具清單會爆增 token 數量和成本
  • 覆蓋缺口:大多數伺服器卡在 40~50 個工具,限制了你所能建構的範圍

你可以透過我們的網站API,甚至在你自己的資料上開源使用 Strata!

影片教學

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

文字教學 查看這個[共享的 Claude 對話](https://claude.ai/share/9b44a192-9f2d-46e2-a875-ef905c457070),親眼見證 Strata 的實際運作!

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

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

**描述**:**建議的起始點**。根據使用者查詢探索可用的類別或動作。當探索各伺服器有哪些可用動作時,請優先嘗試此工具。這是探索可用動作的主要入口點,應在其他搜尋方法之前使用。輸出將是帶有詳細程度和細節的伺服器清單。

如果詳細程度是 'categories_only',細節將僅為類別名稱清單。下一步建議使用 get_category_actions 工具來取得類別中的動作。

如果詳細程度是 'full_details',細節將是包含動作細節的類別名稱清單。這發生在伺服器只有少數動作時。下一步建議使用 execute_action 工具來執行動作。

如果詳細程度是 'categories_and_actions',細節將是類別名稱和動作名稱的清單。這發生在使用外部工具時。下一步建議使用 get_action_details 工具來取得動作的細節。

參數

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

2. 取得類別動作

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

**描述**:取得特定類別中可用 API 動作的全面概覽。如果你想探索特定服務類別中有哪些動作,或取得類別功能的詳細檢視,請使用此工具。\*\* 重要 \*\*:僅應在從 discover_server_categories 工具取得伺服器類別之後呼叫。

參數

  • category_names (陣列,必要):要取得動作的類別清單

3. 取得動作細節

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

**描述**:取得特定動作的詳細資訊,包含必要和選用參數。必須提供類別名稱和動作名稱。\*\* 重要 \*\*:僅應在從先前的工具呼叫取得伺服器類別之後呼叫。

參數

  • category_name (字串,必要):類別的名稱
  • action_name (字串,必要):類別中動作/操作的名稱

4. 執行動作

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

**描述**:使用提供的參數執行特定動作。必須提供伺服器名稱、動作名稱和動作參數。\*\* 重要 \*\*:僅應在從 get_action_details 工具取得動作細節之後呼叫。

參數

  • server_name (字串,必要):伺服器的名稱
  • category_name (字串,必要):要執行動作的類別名稱
  • action_name (字串,必要):要執行的動作/操作名稱
  • path_params (字串,選用):包含動作路徑參數的 JSON 字串
  • query_params (字串,選用):包含動作查詢參數的 JSON 字串
  • body_schema (字串,選用,預設:"{}"):包含動作請求主體的 JSON 字串
  • include_output_fields (陣列,選用):當你從先前的工具呼叫知道此動作的 response_schema 時,強烈建議選用:要包含在回應中的欄位路徑陣列。僅會回傳這些欄位。巢狀欄位使用點表示法(例如 "author.displayName")。
  • maximum_output_characters (整數,選用):選用:要在回應中回傳的最大字元數。如果回應超過此限制,將被截斷。建議優先使用 include_output_fields。

5. 搜尋文件

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

**描述**:**次要選項**:僅在 discover_server_categories 未提供足夠細節,或你需要搜尋特定伺服器的文件時,才使用此工具。使用關鍵字匹配,按類別、操作、標籤或功能搜尋伺服器動作文件。這不是自然語言搜尋,它匹配精確的關鍵字和片語。回傳按相關性排序的端點。使用少量目標關鍵字來找到最佳匹配。常見模式:類別名稱('projects'、'users'、'pipelines')、動作('create'、'delete'、'list'、'get'),或組合('create user'、'list projects')。搜尋演算法使用智慧評分,防止冗長的描述欄位壓過結果。

參數

  • query (字串,必要):匹配 API 文件術語的搜尋關鍵字。最佳實踐:(1) 使用資源名稱,如 'users'、'projects'、'files',(2) 加入動作以提高精確度,如 'user create' 或 'project delete',(3) 避免填充詞,如 'how to'、'show me'、'all the',專注於出現在端點名稱和描述中的核心術語。
  • server_name (字串,必要):要搜尋的伺服器名稱。
  • max_results (整數,選用,預設:10,最小值:1,最大值:50):要回傳的結果數量。預設:10

6. 處理驗證失敗

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

**描述**:處理執行動作時發生的驗證失敗。關鍵:此工具僅應在 execute_action 因驗證問題(401 未授權、無效憑證、過期權杖等)而失敗時呼叫。請勿呼叫此工具來檢查驗證狀態或用於任何其他目的。用法:(1) 當 execute_action 回傳驗證錯誤時,使用 'get_auth_url' 呼叫此工具以取得驗證說明。(2) 當使用者在失敗後提供驗證資料時,使用 'save_auth_data' 呼叫此工具以儲存憑證。如果失敗不是驗證失敗(例如 404 找不到、500 內部伺服器錯誤等),切勿呼叫此工具。

參數

  • server_name (字串,必要):在 execute_action 期間驗證失敗的伺服器名稱
  • intention (字串,必要,列舉:["get_auth_url", "save_auth_data"]):當 execute_action 因驗證錯誤失敗時,使用 'get_auth_url' 取得驗證說明。當使用者在驗證失敗後提供驗證憑證時,使用 'save_auth_data'。
  • auth_data (物件,選用):使用者在驗證失敗後提供的驗證資料(例如 {"token": "...", "api_key": "..."})。僅在解決驗證失敗時與 'save_auth_data' 意圖一起使用。

評估

Strata 帶來了真實的成果:

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

下一步

在幾分鐘內建立你的第一個 Strata 伺服器 探索完整的 Strata API