> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hybridbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP指南

> 通过模型上下文协议端点和工具使用 Hybridbox。

# MCP 指南

Hybridbox 为想要通过 A2A 代理运行时发现和调用 Hybridbox 伪函数的代理客户端公开模型上下文协议 (MCP) 端点。

MCP 端点是 `/mcp`。源路由为 MCP JSON-RPC 请求注册 `POST /mcp`。 `GET /mcp` 已注册，但返回方法不允许，因此客户端应使用 POST 处理 MCP 流量。

<Note />

## 协议面

支持的 JSON-RPC 方法包括：

* `initialize`
* `ping`
* `notifications/initialized`
* `tools/list`
* `tools/call`

`tools/list` 和 `tools/call` 需要经过身份验证的会话。可见工具和可调用函数取决于经过身份验证的会话。

## MCP 工具

### `Hybridbox_functions_list`

列出对经过身份验证的会话可见的 Hybridbox 伪函数。该工具不接受参数。

当代理需要在调用任何内容之前了解哪些功能可用时，请首先使用此功能。

### `Hybridbox_functions_explain`

通过架构、文档和示例解释可见的 Hybridbox 伪函数。

论据：

* `function`：可选的单个伪函数名称来解释。
* `functions`：用于解释的可选伪函数名称数组。

在执行之前使用它，以便代理可以验证名称、必需参数、可选参数和预期结果。

### `Hybridbox_execute`

通过与 A2A 代理相同的授权和执行路径，使用伪 python 代码执行 Hybridbox 公共伪函数。

论据：

* `code`：包含伪Python Hybridbox函数调用代码的必需字符串，例如`domains.list(account_id='acc_123')`。

<Warning>
  仅在检查相关函数架构并验证参数后才执行代码。执行路径使用经过身份验证的会话的授权配置文件。
</Warning>

## 推荐的工作流程

<Steps>
  <Step title="List functions">
    调用 `tools/list`，然后调用 `Hybridbox_functions_list` 以检查可用于经过身份验证的会话的伪函数。
  </Step>

  <Step title="Explain functions">
    在执行前用 `function` 或 `functions` 调用 `Hybridbox_functions_explain`。使用返回的架构和示例来准备有效的参数。
  </Step>

  <Step title="Execute with validated arguments">
    仅在函数名称和参数与解释的架构匹配后才使用 `code` 字符串调用 `Hybridbox_execute`。
  </Step>
</Steps>

## 函数目录

生成的 A2A 函数目录是可用 Hybridbox 伪函数及其签名的参考。

<CardGroup cols={2}>
  <Card title="A2A function catalog" icon="list" href="/zh-cn/agents/a2a-function-catalog">
    浏览生成的函数签名、功能和公共 API 路由映射。
  </Card>

  <Card title="Raw function catalog JSON" icon="code" href="/a2a_functions.v1.json">
    检查生成的 `Hybridbox.A2A.functions.v1` 目录数据。
  </Card>
</CardGroup>