Klavis Strata MCP Server

官方

一个MCP服务器,供AI代理在任何规模下可靠地使用任何工具

文档

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 智能体的三大主要问题:

  • 工具过载:工具太多导致大语言模型选择困难
  • 上下文过载:冗长的工具列表会消耗大量 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%。(来源
  • 人工评估:在超过 2000 个真实世界查询评估集上,准确率达到 83% 以上

后续步骤

几分钟内创建你的第一个 Strata 服务器 探索完整的 Strata API