MCP Environment & Installation Manager

Implementation Reference

• src/tools/installation-tools.ts:46-79 (registration)

  Registration of the 'get-mcp-package' MCP tool, including inline input schema using Zod and the complete handler function that retrieves and returns installed package details via the PackageManager service.

  server.tool(
    "get-mcp-package",
    {
      packageName: z.string().describe("Package name to get details for")
    },
    async ({ packageName }, extra) => {
      if (!packageName.trim()) {
        throw new Error("Package name cannot be empty");
      }
      
      const pkg = packageManager.getInstalledPackage(packageName);
      
      if (!pkg) {
        throw new Error(`Package not installed: ${packageName}`);
      }
      
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify({
              name: pkg.name,
              version: pkg.version,
              localPath: pkg.localPath,
              binPath: pkg.binPath,
              installedAt: pkg.installedAt,
              updatedAt: pkg.updatedAt,
              usedByConfigs: pkg.usedByConfigs
            }, null, 2)
          }
        ]
      };
    }
  );

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

  Invocation of registerInstallationTools on the main MCP server instance, which registers the 'get-mcp-package' tool among others.

  registerInstallationTools(server, configService, packageManager);

• src/tools/installation-tools.ts:48-50 (schema)

  Zod input schema for the 'get-mcp-package' tool defining the 'packageName' parameter.

  {
    packageName: z.string().describe("Package name to get details for")
  },

• src/tools/installation-tools.ts:51-78 (handler)

  The handler implementation for the 'get-mcp-package' tool. Validates input, fetches package from PackageManager, and formats response as MCP content.

  async ({ packageName }, extra) => {
    if (!packageName.trim()) {
      throw new Error("Package name cannot be empty");
    }
    
    const pkg = packageManager.getInstalledPackage(packageName);
    
    if (!pkg) {
      throw new Error(`Package not installed: ${packageName}`);
    }
    
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({
            name: pkg.name,
            version: pkg.version,
            localPath: pkg.localPath,
            binPath: pkg.binPath,
            installedAt: pkg.installedAt,
            updatedAt: pkg.updatedAt,
            usedByConfigs: pkg.usedByConfigs
          }, null, 2)
        }
      ]
    };
  }