MCP Environment & Installation Manager

Implementation Reference

• src/tools/installation-tools.ts:19-43 (handler)

  The core handler implementation for the 'list-installed-mcps' tool. It calls packageManager.getInstalledPackages() and formats the result as JSON text content for MCP response.

  server.tool(
    "list-installed-mcps",
    {},
    async (_, extra) => {
      const packages = packageManager.getInstalledPackages();
      
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify({
              count: packages.length,
              packages: packages.map(pkg => ({
                name: pkg.name,
                version: pkg.version,
                installedAt: pkg.installedAt,
                updatedAt: pkg.updatedAt,
                usedByConfigs: pkg.usedByConfigs
              }))
            }, null, 2)
          }
        ]
      };
    }
  );

• src/server.ts:33-33 (registration)

  Top-level registration call that invokes registerInstallationTools, which registers the list-installed-mcps tool among others.

  registerInstallationTools(server, configService, packageManager);

• src/tools/installation-tools.ts:13-43 (registration)

  The registerInstallationTools function that directly registers the list-installed-mcps tool on the MCP server.

  export function registerInstallationTools(
    server: McpServer, 
    configService: ConfigService,
    packageManager: PackageManager
  ): void {
    // List installed MCP packages
    server.tool(
      "list-installed-mcps",
      {},
      async (_, extra) => {
        const packages = packageManager.getInstalledPackages();
        
        return {
          content: [
            {
              type: "text",
              text: JSON.stringify({
                count: packages.length,
                packages: packages.map(pkg => ({
                  name: pkg.name,
                  version: pkg.version,
                  installedAt: pkg.installedAt,
                  updatedAt: pkg.updatedAt,
                  usedByConfigs: pkg.usedByConfigs
                }))
              }, null, 2)
            }
          ]
        };
      }
    );

• src/services/package-manager.ts:68-70 (helper)

  Helper method getInstalledPackages() used by the tool handler to retrieve the list of all installed MCP packages from the internal registry.

  getInstalledPackages(): InstalledPackage[] {
    return Object.values(this.registry.packages);
  }