TrueTick MCP Server 用于让 AI 智能体直接管理 TrueTick Minecraft 服务器。它通过 MCP（模型上下文协议）向 Claude 及其他兼容的 AI 客户端暴露 30 个工具，覆盖 TrueTick 公共 API 中面向服务器的部分，包括生命周期、控制台、指标与 tick 历史、文件、备份、模组、模板和钱包。
需要说明的是，它并非完整 API：公共接口共有 98 个操作。网络、容量和区域在此没有任何工具；在账户级操作中仅覆盖钱包（get_wallet），账本、账户限额和结账链接均未包含。这些操作需要直接调用 REST API。
安装与设置
-
获取 API 密钥 访问 truetick.gg/dashboard/api-keys 创建 API 密钥，并选择所需的作用域（例如 servers:read、servers:write、billing:read）。
-
配置 Claude Desktop 将相应配置添加到 Claude Desktop 配置文件中（Windows 为 %APPDATA%\Claude\claude_desktop_config.json，Mac 为 ~/Library/Application Support/Claude/claude_desktop_config.json，Linux 为 ~/.config/Claude/claude_desktop_config.json）。将 ttk_your_key_here 替换为实际 API 密钥。
-
配置项 MCP 服务器从环境变量读取配置：
- TRUETICK_API_KEY（必填）：具有适当作用域的 TrueTick API 密钥。
- TRUETICK_API_URL（可选，默认 https://api.truetick.gg）：API 端点，可在测试其他环境时覆盖。
工具能力
账户与钱包
- whoami：显示 API 密钥绑定的账户。
- list_servers：列出所有 Minecraft 服务器。
- get_wallet：显示钱包余额和近期交易。
服务器管理
- create_server：创建新的 Minecraft 服务器（可指定名称、内存、服务器类型、版本、区域、计费方案）。
- get_server：获取指定服务器的详细信息。
- start_server：启动已停止的服务器。
- stop_server：停止运行中的服务器。
- restart_server：重启运行中的服务器。
- delete_server：永久删除服务器及其所有数据。
- update_server_version：更改服务器类型和/或版本（服务器必须处于停止状态）。
- set_server_properties：更新 server.properties 键值及可选的空闲超时。
- set_server_motd：设置服务器的每日消息（MOTD）。
- list_templates：列出可用于创建的服务器模板（预设）。
- create_server_from_template：从模板预设创建服务器。
控制台与指标
- run_command：在运行中的服务器上执行控制台（RCON）命令。
- get_server_metrics：获取服务器的实时 TPS/MSPT/玩家数量指标。读取 tps 时需结合 tpsSource：TPS_SOURCE_UNSPECIFIED 表示没有读数，而非性能为零。
- get_server_tick_history：按一分钟为桶获取 tick 健康数据（默认 24 小时，最大 720）。服务器休眠的分钟没有对应行——空缺就是真实空缺，绝不是零。
- get_recent_logs：获取服务器最近的容器日志行（快照）。
文件管理
- list_files：列出服务器上某个目录中的文件。
- read_file：读取服务器上文件的内容。
- write_file：向服务器上的文件写入内容。
- delete_file：删除服务器上的文件。
- create_backup：为服务器创建按需备份。
- list_backups：列出服务器可用的备份。
- restore_backup：恢复备份（服务器必须处于停止状态；会覆盖当前数据）。
- set_backup_kept：将备份设为保留（kept: true）以移出轮换，直到取消保留；或恢复轮换（kept: false）。每台服务器最多 3 个；保留的备份计入服务器的备份空间。
- list_mods：列出服务器上已安装的模组/插件。
- add_mod：从 Modrinth 或 CurseForge 添加模组或插件。
- list_mod_versions：列出该服务器可固定（pin）的模组或插件构建（仅限其加载器和 Minecraft 版本，包含预发布版）；可将其中一个作为 version 传给 add_mod。
- remove_mod：从服务器移除模组或插件。
许可与仓库说明 项目采用 MIT 许可，详见 LICENSE。TrueTick 的开发在私有 monorepo 中进行；本仓库镜像 @truetick/mcp 的已发布版本。欢迎在此提交 issue 和讨论；如需贡献代码，请先在 issue 中提出变更建议。相关资源：TypeScript SDK 与 CLI、开发者文档、truetick.gg/developers。
