Minecraft Server MCP

Instructions

Implementation Reference

• src/tools/server-tools.ts:126-162 (handler)

  The `configure_mcp` tool is defined in `src/tools/server-tools.ts` using `server.tool`. It accepts various configuration parameters, updates the server manager's configuration via `manager.updateConfig`, and returns the updated configuration.

  // --- Configure Server ---
  server.tool(
    "configure_mcp",
    "Update the MCP server configuration (server directory, JAR path, RCON settings, Java path, JVM args).",
    {
      server_dir: z.string().optional().describe("Path to the Minecraft server directory"),
      server_jar: z.string().optional().describe("Server JAR filename or path"),
      java_path: z.string().optional().describe("Java executable path"),
      jvm_args: z.array(z.string()).optional().describe("JVM arguments array"),
      rcon_host: z.string().optional().describe("RCON host"),
      rcon_port: z.number().optional().describe("RCON port"),
      rcon_password: z.string().optional().describe("RCON password"),
      backup_dir: z.string().optional().describe("Backup directory path"),
    },
    async (params) => {
      const updates: Record<string, unknown> = {};
      if (params.server_dir) updates.serverDir = params.server_dir;
      if (params.server_jar) updates.serverJar = params.server_jar;
      if (params.java_path) updates.javaPath = params.java_path;
      if (params.jvm_args) updates.jvmArgs = params.jvm_args;
      if (params.rcon_host) updates.rconHost = params.rcon_host;
      if (params.rcon_port) updates.rconPort = params.rcon_port;
      if (params.rcon_password) updates.rconPassword = params.rcon_password;
      if (params.backup_dir) updates.backupDir = params.backup_dir;
  
      manager.updateConfig(updates);
      const config = manager.getConfig();
      return {
        content: [
          {
            type: "text",
            text: `Configuration updated:\n${JSON.stringify(config, null, 2)}`,
          },
        ],
      };
    }
  );