MCP 模式与 AI 智能体集成

让 AI 智能体通过模型上下文协议管理你的 Minecraft 实例——Polymerium 独有功能。

上次更新

什么是 MCP？

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

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

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

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

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

启动 MCP 服务器

trident --mcp

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

AI 客户端配置

Claude Desktop

添加到你的 claude_desktop_config.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 使用相同的数据目录——不要同时运行两者。

MCP 模式与 AI 智能体集成

目录