# MCP 工具

> 六个公开 MCP 工具的生成型参数说明。

规范地址: https://keta1930.github.io/icml2026-mcp/zh/docs/reference/mcp-tools



MCP 客户端会直接从服务读取这些 schema。下表由同一份源码生成。

## 行为 [#行为]

* 结果和错误都以简短英文文本返回。
* 不传 `session_id` 的搜索不保存记录。
* 在搜索会话中，已经返回的论文会被记录，后续搜索不会重复返回。

## 生成型参数表 [#生成型参数表]

{/* Generated by docs/scripts/generate_reference.py. */}

### `open_search_session` — 打开搜索会话 [#open_search_session--打开搜索会话]

创建搜索会话并返回 ID。把这个 ID 传给后续搜索，即可略过该会话已经返回的论文。

| 参数              | 类型                | 必填 | 默认值  | 约束        | 说明             |
| --------------- | ----------------- | -: | ---- | --------- | -------------- |
| `label`         | `string`          |  否 | `""` | 字符数最多 120 | 会话的可选主题标签。     |
| `default_top_k` | `integer \| null` |  否 | 未设置  | ≥ 1, ≤ 50 | 该会话每轮默认返回的结果数。 |

返回 MCP 文本内容；失败时使用稳定的 `error[code]` 文本。

### `search_papers` — 搜索论文 [#search_papers--搜索论文]

搜索 6,341 篇 ICML 2026 论文；传入 `session_id` 时，不再返回该会话已经给出的论文。

| 参数                 | 类型                | 必填 | 默认值   | 约束                  | 说明                   |
| ------------------ | ----------------- | -: | ----- | ------------------- | -------------------- |
| `query`            | `string`          |  是 | —     | 字符数最少 1, 字符数最多 2000 | 自然语言研究主题或方法。         |
| `session_id`       | `string \| null`  |  否 | 未设置   | —                   | 搜索会话 ID，用于略过已经返回的论文。 |
| `top_k`            | `integer \| null` |  否 | 未设置   | ≥ 1, ≤ 50           | 最多返回的新论文数。           |
| `search_depth`     | `integer \| null` |  否 | 未设置   | ≥ 1                 | 会话去重前最多检查的已排名候选论文数量。 |
| `area`             | `string \| null`  |  否 | 未设置   | —                   | 研究领域过滤条件。            |
| `paper_type`       | `string \| null`  |  否 | 未设置   | —                   | 论文类型过滤条件。            |
| `spotlight_only`   | `boolean`         |  否 | false | —                   | 是否只返回 spotlight 论文。  |
| `min_score`        | `number \| null`  |  否 | 未设置   | ≥ 0.0, ≤ 1.0        | 归一化混合排名分数下限。         |
| `include_abstract` | `boolean`         |  否 | true  | —                   | 是否在结果中包含摘要预览。        |

返回 MCP 文本内容；失败时使用稳定的 `error[code]` 文本。

### `close_search_session` — 关闭搜索会话 [#close_search_session--关闭搜索会话]

关闭一个搜索会话，并返回简短汇总。

| 参数           | 类型       | 必填 | 默认值 | 约束      | 说明           |
| ------------ | -------- | -: | --- | ------- | ------------ |
| `session_id` | `string` |  是 | —   | 字符数最少 1 | 要关闭的搜索会话 ID。 |

返回 MCP 文本内容；失败时使用稳定的 `error[code]` 文本。

### `search_session_status` — 搜索会话状态 [#search_session_status--搜索会话状态]

查看一个搜索会话的进度。

| 参数               | 类型        | 必填 | 默认值   | 约束      | 说明               |
| ---------------- | --------- | -: | ----- | ------- | ---------------- |
| `session_id`     | `string`  |  是 | —     | 字符数最少 1 | 要检查的搜索会话 ID。     |
| `include_papers` | `boolean` |  否 | false | —       | 是否包含数量有限的论文标题列表。 |

返回 MCP 文本内容；失败时使用稳定的 `error[code]` 文本。

### `get_papers` — 获取论文 [#get_papers--获取论文]

根据 OpenReview ID 获取论文；传入 `session_id` 时，把找到的论文记录为该会话已经返回的结果。

| 参数           | 类型               | 必填 | 默认值 | 约束                | 说明                      |
| ------------ | ---------------- | -: | --- | ----------------- | ----------------------- |
| `paper_ids`  | `string[]`       |  是 | —   | 条目数最少 1, 条目数最多 50 | OpenReview 论文 ID。       |
| `session_id` | `string \| null` |  否 | 未设置 | —                 | 在其中把找到的论文记录为已返回结果的搜索会话。 |

返回 MCP 文本内容；失败时使用稳定的 `error[code]` 文本。

### `list_paper_areas` — 列出论文领域 [#list_paper_areas--列出论文领域]

列出可用的 `area` 和 `paper_type` 值及语料库计数。

| 参数 | 类型 | 必填 | 默认值 | 约束 | 说明  |
| -- | -- | -: | --- | -- | --- |
| —  | —  |  — | —   | —  | 无参数 |

返回 MCP 文本内容；失败时使用稳定的 `error[code]` 文本。

## 相关文档 [#相关文档]

* 排名行为：[检索](https://keta1930.github.io/icml2026-mcp/zh/docs/concepts/hybrid-search)
* 会话行为：[搜索会话](https://keta1930.github.io/icml2026-mcp/zh/docs/concepts/sessions)
* 稳定失败分类：[错误码](https://keta1930.github.io/icml2026-mcp/zh/docs/reference/errors)