Klavis Strata

官方

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

访问 klavis.ai

你可以用 Klavis Strata MCP 做什么？

发现各服务器上的可用操作 — 让AI通过描述你的需求来查找相关工具，建议以 discover_server_categories_or_actions 作为首选起点。
探索类别内的操作 — 在发现可用类别后，使用 get_category_actions 获取特定服务类别中的所有操作名称。
获取操作的参数架构 — 在执行操作前，通过 get_action_details 获取某个操作的完整输入详情。
执行API操作 — 使用 execute_action 运行已发现的操作并传入所需参数，可选择过滤输出字段以减少响应大小。
按关键词搜索服务器文档 — 当类别发现需要更高精度时，使用 search_documentation 并输入针对性关键词，如"创建用户"或"列出项目"。
解决身份验证失败 — 当操作因401错误失败时，调用 handle_auth_failure 获取身份验证说明或保存凭据。

文档

Strata

一个 MCP 服务器，让 AI 智能体在任何规模下逐步使用工具

什么是 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