HIPAA Guardian MCP Server

Implementation Reference

• server.ts:80-88 (handler)

  The handler function that implements the logic for the 'getCoreDefinitions' tool. It returns core HIPAA definitions from the hipaaData knowledge base as text content.

  async ({ term }) => {
    // Return the entire section as it contains all definitions contextually.
    return {
      content: [{
        type: 'text',
        text: `Here are the core definitions from the guide:\n\n${hipaaData['what_is_hipaa?']}`
      }]
    };
  }

• server.ts:76-78 (schema)

  Zod schema defining the input for the tool: an object with a 'term' field enum of specific HIPAA terms.

  schema: z.object({
    term: z.enum(['PHI', 'Business Associate', 'De-Identification', 'Patient Rights']),
  }),

• server.ts:72-89 (registration)

  The server.tool call that registers the 'getCoreDefinitions' tool, providing name, description, schema, and handler function.

  server.tool(
    'getCoreDefinitions',
    {
      description: 'Provides foundational definitions for terms like PHI (Protected Health Information), Business Associate, and De-Identification.',
      schema: z.object({
        term: z.enum(['PHI', 'Business Associate', 'De-Identification', 'Patient Rights']),
      }),
    },
    async ({ term }) => {
      // Return the entire section as it contains all definitions contextually.
      return {
        content: [{
          type: 'text',
          text: `Here are the core definitions from the guide:\n\n${hipaaData['what_is_hipaa?']}`
        }]
      };
    }
  );

• server.ts:8-18 (helper)

  Loads the hipaaData JSON knowledge base at startup, which is used by the getCoreDefinitions handler to provide definitions.

  const knowledgeBasePath = path.join(process.cwd(), 'hipaa-content.json');
  let hipaaData;
  try {
    hipaaData = JSON.parse(fs.readFileSync(knowledgeBasePath, 'utf-8'));
    console.log('✅ HIPAA knowledge base loaded successfully');
  } catch (error) {
    console.error(`FATAL ERROR: Could not load knowledge base from ${knowledgeBasePath}.`);
    console.error('Please ensure the hipaa-content.json file exists in the same directory.');
    console.error('Error details:', error);
    process.exit(1); // Exit if the core data is missing
  }