MCP Environment & Installation Manager

Implementation Reference

• src/tools/environment-tools.ts:12-51 (registration)

  Registration of the 'list-env-vars' MCP tool, including the input schema (profileId parameter) and the complete inline handler function that lists environment variables for a profile, masking sensitive ones.

  // List environment variables
  server.tool(
    "list-env-vars",
    {
      profileId: z.string().describe("Profile ID to list environment variables from")
    },
    async ({ profileId }, extra) => {
      if (!profileId.trim()) {
        throw new Error("Profile ID cannot be empty");
      }
      
      const profile = configService.getProfile(profileId);
      if (!profile) {
        throw new Error(`Profile not found: ${profileId}`);
      }
      
      const envVars = configService.getEnvVars(profileId);
      
      // Transform to array and mask sensitive values
      const result = Object.entries(envVars).map(([key, envVar]) => ({
        key,
        value: envVar.sensitive ? '********' : envVar.value,
        sensitive: envVar.sensitive,
        description: envVar.description
      }));
      
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify({
              profileId,
              profileName: profile.name,
              variables: result
            }, null, 2)
          }
        ]
      };
    }
  );

• src/tools/environment-tools.ts:18-50 (handler)

  The handler function implementing the core logic of 'list-env-vars': validates profileId, retrieves profile and env vars via ConfigService, formats output masking sensitive values, and returns structured text content.

  async ({ profileId }, extra) => {
    if (!profileId.trim()) {
      throw new Error("Profile ID cannot be empty");
    }
    
    const profile = configService.getProfile(profileId);
    if (!profile) {
      throw new Error(`Profile not found: ${profileId}`);
    }
    
    const envVars = configService.getEnvVars(profileId);
    
    // Transform to array and mask sensitive values
    const result = Object.entries(envVars).map(([key, envVar]) => ({
      key,
      value: envVar.sensitive ? '********' : envVar.value,
      sensitive: envVar.sensitive,
      description: envVar.description
    }));
    
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({
            profileId,
            profileName: profile.name,
            variables: result
          }, null, 2)
        }
      ]
    };
  }

• src/tools/environment-tools.ts:15-17 (schema)

  Input schema for 'list-env-vars' tool defining the required 'profileId' parameter using Zod.

  {
    profileId: z.string().describe("Profile ID to list environment variables from")
  },

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

  High-level registration call that invokes registerEnvironmentTools, thereby registering 'list-env-vars' and other environment tools on the MCP server.

  registerEnvironmentTools(server, configService);