---
title: MCP 模式与 AI 智能体集成
description: 让 AI 智能体通过模型上下文协议管理你的 Minecraft 实例——Polymerium 独有功能。
---

## 什么是 MCP？

模型上下文协议（Model Context Protocol，MCP）是 AI 智能体与外部工具交互的标准。Polymerium 的 CLI（`trident`）可以作为 MCP 服务器运行，暴露 30 多个工具供 AI 智能体直接调用。

这意味着你可以让 AI 助手：

- "创建一个 Fabric 1.21.4 实例，装上性能优化模组"
- "先打个快照，然后把 Sodium 更新到最新版本"
- "将这个实例导出为 Modrinth 整合包"

它就会帮你完成——无需手动点击。

**没有其他 Minecraft 启动器支持这个功能。**

## 启动 MCP 服务器

```bash
trident --mcp
```

这会通过 stdio 启动一个 MCP 服务器。将你的 AI 客户端（Claude、Cursor 等）连接到它作为工具提供者。

## AI 客户端配置

### Claude Desktop

添加到你的 `claude_desktop_config.json`：

```json
{
  "mcpServers": {
    "polymerium": {
      "command": "trident",
      "args": ["--mcp"]
    }
  }
}
```

### Cursor

在 Cursor 的设置中添加为 MCP 工具服务器，指向 `trident --mcp`。

### 其他客户端

任何支持通过 stdio 使用 MCP 的客户端都可以连接。服务器使用标准的 MCP 协议。

## 可用工具（30+）

### 实例工具

| 工具 | 说明 |
|------|-------------|
| `instance_list` | 列出所有实例 |
| `instance_inspect` | 查看实例详情 |
| `instance_create` | 创建新实例 |
| `instance_delete` | 删除实例 |
| `instance_unlock` | 解除导入实例的源绑定 |
| `instance_reset` | 重置构建（清除 build/ 和 live/） |
| `instance_export` | 将实例导出为整合包 |
| `instance_import` | 导入整合包文件 |

### 包工具

| 工具 | 说明 |
|------|-------------|
| `package_list` | 列出已安装的模组 |
| `package_search` | 搜索 CurseForge / Modrinth |
| `package_add` | 通过 purl 添加模组 |
| `package_inspect` | 查看模组详情 |
| `package_enable` / `package_disable` | 切换模组状态 |
| `package_dependency_list` | 列出模组的依赖项 |
| `package_dependent_list` | 列出依赖于指定模组的其他模组 |
| `package_version_list` | 列出可用版本 |
| `package_version_set` | 固定特定版本 |

### 加载器工具

| 工具 | 说明 |
|------|-------------|
| `loader_list` | 列出实例的加载器 |
| `loader_version_list` | 列出可用的加载器版本 |
| `loader_get` / `loader_set` | 获取或设置加载器 |

### 配置工具

| 工具 | 说明 |
|------|-------------|
| `config_get` / `config_set` | 读取/写入配置 |
| `config_list` / `config_unset` | 列出或移除配置键 |

### 账户工具

| 工具 | 说明 |
|------|-------------|
| `account_list` | 列出账户 |
| `account_add_offline` | 添加离线账户 |
| `account_remove` | 移除账户 |

### 仓库工具

| 工具 | 说明 |
|------|-------------|
| `repository_list` | 列出已配置的仓库 |
| `repository_status` | 检查仓库连接状态 |
| `repository_add` / `repository_remove` | 添加或移除仓库 |

## 示例会话

### 创建性能优化整合包

```
你：创建一个名为 "perf-pack" 的 Fabric 1.21.4 实例，装上 Sodium、Lithium 和 Iris。

Agent：我来创建实例并添加模组。
  → instance_create("perf-pack", version="1.21.4", loader="fabric")
  → package_add("modrinth:sodium")
  → package_add("modrinth:lithium")
  → package_add("modrinth:iris")
  → instance_build("perf-pack")
  完成！你的 "perf-pack" 实例已准备就绪。
```

### 安全实验

```
你：给我的 "skyblock" 实例打个快照，然后更新所有模组。

Agent：
  → instance_inspect("skyblock")   // 确认实例存在
  → snapshot_create("skyblock", name="before-bulk-update")
  → package_version_list(...)      // 检查每个模组是否有更新
  → package_version_set(...)       // 应用更新
  → instance_build("skyblock")
  快照已保存。所有模组已更新并重新部署。
  如果出现问题，可以恢复 "before-bulk-update" 快照。
```

## 限制

- MCP 通过 stdio 运行——设计用于本地使用，不适用于远程服务器。
- 微软账户登录需要设备代码流（Device Code Flow），对无头 AI 交互不够理想。在自动化工作流中请使用离线账户。
- MCP 服务器与 GUI 使用相同的数据目录——不要同时运行两者。
