truetick-gg

TrueTick MCP Server

AI エージェントから TrueTick の Minecraft サーバーを直接管理できます。この MCP サーバーは、TrueTick の公開 API のうちサーバー関連の機能（ライフサイクル、コンソール、メトリクスとティック履歴、ファイル、バックアップ、MOD、テンプレート、ウォレット）を網羅する 30 個のツールを、Claude やその他の互換性のある AI クライアントに提供します。

API 全体を網羅しているわけではありません。公開されている操作は 98 個です。ネットワーク、容量、リージョンには、この MCP サーバーにツールがありません。また、アカウント単位の操作で対応しているのはウォレット（get_wallet）のみで、台帳、アカウント制限、チェックアウトリンクには対応していません。これらの操作には、REST API を直接呼び出してください。

インストールとセットアップ

1. API キーを取得する

truetick.gg/dashboard/api-keys にアクセスして API キーを作成します。必要なスコープ（例：servers:read、servers:write、billing:read）を選択してください。

2. 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）に追加します。

{
  "mcpServers": {
    "truetick": {
      "command": "npx",
      "args": ["-y", "@truetick/mcp"],
      "env": {
        "TRUETICK_API_KEY": "ttk_your_key_here"
      }
    }
  }
}

ttk_your_key_here を実際の API キーに置き換えてください。

3. 設定

MCP サーバーは、次の環境変数から設定を読み込みます。

• TRUETICK_API_KEY（必須）：適切なスコープが設定された TrueTick API キーです。
• TRUETICK_API_URL（任意、デフォルトは https://api.truetick.gg）：API エンドポイントです。別の環境でテストする場合は、値を変更してください。

ツール一覧

アカウントとウォレット

• whoami — API キーに紐付けられたアカウントを表示します。
• list_servers — すべての Minecraft サーバーを一覧表示します。
• get_wallet — ウォレット残高と最近の取引を表示します。

サーバー管理

• create_server — 新しい Minecraft サーバーを作成します（名前、RAM、サーバータイプ、バージョン、リージョン、料金プランを指定します）。
• get_server — 特定のサーバーの詳細を取得します。
• start_server — 停止中のサーバーを起動します。
• stop_server — 実行中のサーバーを停止します。
• restart_server — 実行中のサーバーを再起動します。
• delete_server — サーバーとそのすべてのデータを完全に削除します。
• update_server_version — サーバータイプやバージョンを変更します（サーバーを停止しておく必要があります）。
• set_server_properties — server.properties のキーと、任意のアイドルタイムアウトを更新します。
• set_server_motd — サーバーの MOTD（Message of the Day）を設定します。
• list_templates — サーバー作成に使用できるテンプレート（プリセット）を一覧表示します。
• create_server_from_template — テンプレートのプリセットからサーバーを作成します。

コンソールとメトリクス

• run_command — 実行中のサーバーでコンソール（RCON）コマンドを実行します。
• get_server_metrics — サーバーの現在の TPS、MSPT、プレイヤー数のメトリクスを取得します。tps は tpsSource と併せて確認してください。TPS_SOURCE_UNSPECIFIED は、パフォーマンスがゼロではなく、測定値がないことを意味します。
• get_server_tick_history — ティックの状態を 1 分単位で記録した履歴を取得します（デフォルトは 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 件まで保持でき、保持中のバックアップはサーバーのバックアップ容量に含まれます。

Mods & Plugins

• list_mods — サーバーにインストールされている Mod／プラグインを一覧表示します。
• add_mod — Modrinth または CurseForge から Mod またはプラグインを追加します。
• list_mod_versions — このサーバーで固定できる Mod またはプラグインのビルドを一覧表示します（ローダーと Minecraft のバージョンが一致するもののみ。プレリリースも含みます）。そのうちの 1 つを version として add_mod に渡してください。
• remove_mod — サーバーから Mod またはプラグインを削除します。

開発

npm run build      # Compile TypeScript
npm test           # Run tests
npm start          # Run the MCP server (for manual testing)

ライセンス

MIT — LICENSE をご覧ください。

このリポジトリについて

TrueTick の開発は非公開のモノレポで行われており、このリポジトリには @truetick/mcp のリリース済みバージョンがミラーされています。問題やディスカッションはこのリポジトリで歓迎します。 コードへの貢献を希望する場合は、まず issue で変更案を提案してください。

関連リンク：TypeScript SDK & CLI · 開発者向けドキュメント · truetick.gg/developers