MCP Environment & Installation Manager

Implementation Reference

• src/tools/environment-tools.ts:60-94 (handler)

  Handler function that implements the logic for the 'get-env-var' tool: validates profileId and key, retrieves the profile and environment variable using ConfigService, handles errors, masks sensitive values, and returns a structured text response.

  async ({ profileId, key }, extra) => {
    if (!profileId.trim()) {
      throw new Error("Profile ID cannot be empty");
    }
    
    if (!key.trim()) {
      throw new Error("Environment variable key cannot be empty");
    }
    
    const profile = configService.getProfile(profileId);
    if (!profile) {
      throw new Error(`Profile not found: ${profileId}`);
    }
    
    const envVar = configService.getEnvVar(profileId, key);
    if (!envVar) {
      throw new Error(`Environment variable not found: ${key}`);
    }
    
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({
            profileId,
            profileName: profile.name,
            key,
            value: envVar.sensitive ? '********' : envVar.value,
            sensitive: envVar.sensitive,
            description: envVar.description
          }, null, 2)
        }
      ]
    };
  }

• src/tools/environment-tools.ts:56-59 (schema)

  Zod input schema for the 'get-env-var' tool, defining required parameters profileId (string) and key (string) with descriptions.

  {
    profileId: z.string().describe("Profile ID to get environment variable from"),
    key: z.string().describe("Environment variable key")
  },

• src/tools/environment-tools.ts:54-95 (registration)

  Direct registration of the 'get-env-var' tool using server.tool(), specifying the tool name, input schema, and handler function within the registerEnvironmentTools function.

  server.tool(
    "get-env-var",
    {
      profileId: z.string().describe("Profile ID to get environment variable from"),
      key: z.string().describe("Environment variable key")
    },
    async ({ profileId, key }, extra) => {
      if (!profileId.trim()) {
        throw new Error("Profile ID cannot be empty");
      }
      
      if (!key.trim()) {
        throw new Error("Environment variable key cannot be empty");
      }
      
      const profile = configService.getProfile(profileId);
      if (!profile) {
        throw new Error(`Profile not found: ${profileId}`);
      }
      
      const envVar = configService.getEnvVar(profileId, key);
      if (!envVar) {
        throw new Error(`Environment variable not found: ${key}`);
      }
      
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify({
              profileId,
              profileName: profile.name,
              key,
              value: envVar.sensitive ? '********' : envVar.value,
              sensitive: envVar.sensitive,
              description: envVar.description
            }, null, 2)
          }
        ]
      };
    }
  );

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

  High-level registration call to registerEnvironmentTools in the main server initialization, which includes the 'get-env-var' tool among environment management tools.

  registerEnvironmentTools(server, configService);