Skip to main content
Glama
kongyo2

Stellaris Modding MCP Server

by kongyo2
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

stellaris-version

Retrieve current Stellaris version details, including build ID, last update time, and available version numbers, to support modding activities effectively.

Instructions

ステラリスの現在のバージョン情報を取得します。ビルドID、最終更新日時、利用可能なバージョン番号などmodding に必要な情報を提供します。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Implementation Reference

  • src/server.ts:297-435 (registration)
    Registration of the 'stellaris-version' tool using FastMCP server.addTool, including annotations, description, handler, name, and empty schema.
      annotations: {
    openWorldHint: true, // 外部APIにアクセスする
    readOnlyHint: true, // データを変更しない
    title: "Stellaris Version Info",
  },
  description:
    "ステラリスの現在のバージョン情報を取得します。ビルドID、最終更新日時、利用可能なバージョン番号などmodding に必要な情報を提供します。",
  execute: async (_args, { log }) => {
    try {
      log.info("Fetching Stellaris version info from SteamCMD API...");

      const appInfo = (await fetchSteamAppInfo(STELLARIS_APP_ID)) as {
        common?: { name?: string; oslist?: string };
        config?: { installdir?: string };
        depots?: {
          branches?: Record<
            string,
            { buildid?: string; description?: string; timeupdated?: string }
          >;
        };
        extended?: { developer?: string; publisher?: string };
      };
      const branches = appInfo.depots?.branches;

      if (!branches) {
        throw new Error("Branch information not found in API response");
      }

      const publicBranch = branches.public;

      // バージョン番号らしきブランチを抽出（数字.数字.数字の形式）
      const versionBranches = Object.keys(branches)
        .filter((branch) => /^\d+\.\d+/.test(branch))
        .sort((a, b) => {
          // バージョン番号でソート
          const aVersion = a.split(".").map((n) => parseInt(n) || 0);
          const bVersion = b.split(".").map((n) => parseInt(n) || 0);
          for (let i = 0; i < Math.max(aVersion.length, bVersion.length); i++) {
            const diff = (bVersion[i] || 0) - (aVersion[i] || 0);
            if (diff !== 0) return diff;
          }
          return 0;
        });

      const latestVersionBranch = versionBranches[0];
      const currentVersionInfo = latestVersionBranch
        ? branches[latestVersionBranch]
        : null;

      const result = {
        availableVersions: versionBranches.slice(0, 10), // 最新10バージョンを表示
        currentPublic: {
          buildId: publicBranch?.buildid,
          lastUpdated: publicBranch?.timeupdated
            ? formatTimestamp(publicBranch.timeupdated)
            : "Unknown",
          lastUpdatedUnix: publicBranch?.timeupdated,
        },
        gameInfo: {
          appId: STELLARIS_APP_ID,
          developer: appInfo.extended?.developer,
          installDir: appInfo.config?.installdir,
          publisher: appInfo.extended?.publisher,
          supportedOS: appInfo.common?.oslist,
        },
        gameName: appInfo.common?.name || "Stellaris",
        latestVersion: latestVersionBranch
          ? {
            buildId: currentVersionInfo?.buildid,
            description: currentVersionInfo?.description || "説明なし",
            lastUpdated: currentVersionInfo?.timeupdated
              ? formatTimestamp(currentVersionInfo.timeupdated)
              : "Unknown",
            lastUpdatedUnix: currentVersionInfo?.timeupdated,
            version: latestVersionBranch,
          }
          : null,
        specialBranches: Object.keys(branches).filter(
          (branch) => !versionBranches.includes(branch) && branch !== "public",
        ),
      };

      log.info("Successfully retrieved Stellaris version info", {
        latestVersion: result.latestVersion?.version,
        publicBuildId: result.currentPublic.buildId,
      });

      return {
        content: [
          {
            text: `# ステラリス バージョン情報

## 現在のPublicブランチ
- **ビルドID**: ${result.currentPublic.buildId}
- **最終更新**: ${result.currentPublic.lastUpdated}

${result.latestVersion
                ? `## 最新バージョン
- **バージョン**: ${result.latestVersion.version}
- **ビルドID**: ${result.latestVersion.buildId}
- **説明**: ${result.latestVersion.description}
- **最終更新**: ${result.latestVersion.lastUpdated}`
                : ""
              }

## ゲーム情報
- **ゲーム名**: ${result.gameName}
- **App ID**: ${result.gameInfo.appId}
- **インストールディレクトリ**: ${result.gameInfo.installDir}
- **対応OS**: ${result.gameInfo.supportedOS}
- **開発者**: ${result.gameInfo.developer}
- **パブリッシャー**: ${result.gameInfo.publisher}

## 利用可能なバージョン（最新10件）
${result.availableVersions.map((version) => `- ${version}`).join("\n")}

## 特別なブランチ
${result.specialBranches.map((branch) => `- ${branch}`).join("\n")}

---
*データ取得元: SteamCMD API (https://api.steamcmd.net/)*`,
            type: "text",
          },
        ],
      };
    } catch (error) {
      const errorMessage =
        error instanceof Error ? error.message : String(error);
      log.error("Failed to fetch Stellaris version info", {
        error: errorMessage,
      });
      throw new Error(
        `ステラリスのバージョン情報の取得に失敗しました: ${errorMessage}`,
      );
    }
  },
  name: "stellaris-version",
  parameters: z.object({}), // パラメータなし
});
  • src/server.ts:304-432 (handler)
    The main handler function that executes the tool: fetches Stellaris app info from SteamCMD API, extracts current/latest versions, build IDs, updates, available versions, and formats into a markdown report.
      execute: async (_args, { log }) => {
    try {
      log.info("Fetching Stellaris version info from SteamCMD API...");

      const appInfo = (await fetchSteamAppInfo(STELLARIS_APP_ID)) as {
        common?: { name?: string; oslist?: string };
        config?: { installdir?: string };
        depots?: {
          branches?: Record<
            string,
            { buildid?: string; description?: string; timeupdated?: string }
          >;
        };
        extended?: { developer?: string; publisher?: string };
      };
      const branches = appInfo.depots?.branches;

      if (!branches) {
        throw new Error("Branch information not found in API response");
      }

      const publicBranch = branches.public;

      // バージョン番号らしきブランチを抽出（数字.数字.数字の形式）
      const versionBranches = Object.keys(branches)
        .filter((branch) => /^\d+\.\d+/.test(branch))
        .sort((a, b) => {
          // バージョン番号でソート
          const aVersion = a.split(".").map((n) => parseInt(n) || 0);
          const bVersion = b.split(".").map((n) => parseInt(n) || 0);
          for (let i = 0; i < Math.max(aVersion.length, bVersion.length); i++) {
            const diff = (bVersion[i] || 0) - (aVersion[i] || 0);
            if (diff !== 0) return diff;
          }
          return 0;
        });

      const latestVersionBranch = versionBranches[0];
      const currentVersionInfo = latestVersionBranch
        ? branches[latestVersionBranch]
        : null;

      const result = {
        availableVersions: versionBranches.slice(0, 10), // 最新10バージョンを表示
        currentPublic: {
          buildId: publicBranch?.buildid,
          lastUpdated: publicBranch?.timeupdated
            ? formatTimestamp(publicBranch.timeupdated)
            : "Unknown",
          lastUpdatedUnix: publicBranch?.timeupdated,
        },
        gameInfo: {
          appId: STELLARIS_APP_ID,
          developer: appInfo.extended?.developer,
          installDir: appInfo.config?.installdir,
          publisher: appInfo.extended?.publisher,
          supportedOS: appInfo.common?.oslist,
        },
        gameName: appInfo.common?.name || "Stellaris",
        latestVersion: latestVersionBranch
          ? {
            buildId: currentVersionInfo?.buildid,
            description: currentVersionInfo?.description || "説明なし",
            lastUpdated: currentVersionInfo?.timeupdated
              ? formatTimestamp(currentVersionInfo.timeupdated)
              : "Unknown",
            lastUpdatedUnix: currentVersionInfo?.timeupdated,
            version: latestVersionBranch,
          }
          : null,
        specialBranches: Object.keys(branches).filter(
          (branch) => !versionBranches.includes(branch) && branch !== "public",
        ),
      };

      log.info("Successfully retrieved Stellaris version info", {
        latestVersion: result.latestVersion?.version,
        publicBuildId: result.currentPublic.buildId,
      });

      return {
        content: [
          {
            text: `# ステラリス バージョン情報

## 現在のPublicブランチ
- **ビルドID**: ${result.currentPublic.buildId}
- **最終更新**: ${result.currentPublic.lastUpdated}

${result.latestVersion
                ? `## 最新バージョン
- **バージョン**: ${result.latestVersion.version}
- **ビルドID**: ${result.latestVersion.buildId}
- **説明**: ${result.latestVersion.description}
- **最終更新**: ${result.latestVersion.lastUpdated}`
                : ""
              }

## ゲーム情報
- **ゲーム名**: ${result.gameName}
- **App ID**: ${result.gameInfo.appId}
- **インストールディレクトリ**: ${result.gameInfo.installDir}
- **対応OS**: ${result.gameInfo.supportedOS}
- **開発者**: ${result.gameInfo.developer}
- **パブリッシャー**: ${result.gameInfo.publisher}

## 利用可能なバージョン（最新10件）
${result.availableVersions.map((version) => `- ${version}`).join("\n")}

## 特別なブランチ
${result.specialBranches.map((branch) => `- ${branch}`).join("\n")}

---
*データ取得元: SteamCMD API (https://api.steamcmd.net/)*`,
            type: "text",
          },
        ],
      };
    } catch (error) {
      const errorMessage =
        error instanceof Error ? error.message : String(error);
      log.error("Failed to fetch Stellaris version info", {
        error: errorMessage,
      });
      throw new Error(
        `ステラリスのバージョン情報の取得に失敗しました: ${errorMessage}`,
      );
    }
  },
  • src/server.ts:434-434 (schema)
    Zod schema for tool parameters: empty object as no parameters are required.
    parameters: z.object({}), // パラメータなし
  • src/server.ts:49-64 (helper)
    Helper function to fetch Steam app information via SteamCMD API, used by the stellaris-version handler.
    async function fetchSteamAppInfo(appId: string): Promise<unknown> {
  const response = await fetchWithRetry(`${STEAMCMD_API_BASE}/info/${appId}`);
  if (!response.ok) {
    throw new Error(
      `Failed to fetch app info: ${response.status} ${response.statusText}`,
    );
  }
  const data = (await response.json()) as {
    data: Record<string, unknown>;
    status: string;
  };
  if (data.status !== "success") {
    throw new Error(`API returned error: ${JSON.stringify(data.data)}`);
  }
  return data.data[appId];
}
  • src/server.ts:69-131 (helper)
    Retry utility with exponential backoff for API calls, crucial for reliable SteamCMD and GitHub API access in the handler.
    async function fetchWithRetry(
  url: string,
  options?: RequestInit,
  retryCount = 0,
): Promise<Response> {
  try {
    const response = await fetch(url, options);

    // レート制限の場合は特別な処理
    if (response.status === 403 && response.statusText.includes("rate limit")) {
      if (retryCount < RETRY_CONFIG.maxRetries) {
        const delay = Math.min(
          RETRY_CONFIG.baseDelay *
          Math.pow(RETRY_CONFIG.backoffMultiplier, retryCount),
          RETRY_CONFIG.maxDelay,
        );

        console.log(
          `Rate limit hit, retrying in ${delay}ms (attempt ${retryCount + 1}/${RETRY_CONFIG.maxRetries})`,
        );
        await new Promise((resolve) => setTimeout(resolve, delay));
        return fetchWithRetry(url, options, retryCount + 1);
      }
    }

    // 一時的なサーバーエラーの場合もリトライ
    if (response.status >= 500 && response.status < 600) {
      if (retryCount < RETRY_CONFIG.maxRetries) {
        const delay = Math.min(
          RETRY_CONFIG.baseDelay *
          Math.pow(RETRY_CONFIG.backoffMultiplier, retryCount),
          RETRY_CONFIG.maxDelay,
        );

        console.log(
          `Server error ${response.status}, retrying in ${delay}ms (attempt ${retryCount + 1}/${RETRY_CONFIG.maxRetries})`,
        );
        await new Promise((resolve) => setTimeout(resolve, delay));
        return fetchWithRetry(url, options, retryCount + 1);
      }
    }

    return response;
  } catch (error) {
    // ネットワークエラーの場合もリトライ
    if (retryCount < RETRY_CONFIG.maxRetries) {
      const delay = Math.min(
        RETRY_CONFIG.baseDelay *
        Math.pow(RETRY_CONFIG.backoffMultiplier, retryCount),
        RETRY_CONFIG.maxDelay,
      );

      console.log(
        `Network error, retrying in ${delay}ms (attempt ${retryCount + 1}/${RETRY_CONFIG.maxRetries}):`,
        error instanceof Error ? error.message : String(error),
      );
      await new Promise((resolve) => setTimeout(resolve, delay));
      return fetchWithRetry(url, options, retryCount + 1);
    }

    throw error;
  }
}
Install Server

Other Tools

Related Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kongyo2/Stellaris-Modding-MCP-Server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server