MCP HuliHealth

A production-ready Model Context Protocol (MCP) server for HuliHealth. This CLI allows n8n or other automation tools to invoke HuliHealth APIs through a standard MCP interface.

---

🚀 Features

• Modular tool-per-file architecture in src/tools/
• OpenAPI-based schemas for type safety
• STDIO or SSE modes for integration flexibility
• Designed for n8n and LLM agents

---

📂 Project Structure

src/           TypeScript source
openapi.json   Reference Huli API specification
PROMT.md       Architecture notes

---

🛠️ Setup

1. Install dependencies

   npm install
   

2. Configure environment variables Copy .env.example to .env and set your credentials.

Running the CLI

Use npx to start the server. Without arguments it runs in STDIO mode. Add --sse or set PORT to start an HTTP SSE server.

npx hulihealth-mcp-dacs           # STDIO mode
npx hulihealth-mcp-dacs --sse     # SSE mode on port $PORT or 3000

Generating new tools

Create new MCP tools with the mcp-gen-tool helper:

npm run mcp-gen-tool create-tool --name=<toolName>

The command scaffolds src/tools/<toolName>.ts with a basic template. After editing the file remember to register the tool in src/mcp/toolRegistry.ts.

n8n Integration

Example configuration to run the MCP from an n8n workflow:

{
  "mcpServers": {
    "hulihealth-mcp": {
      "command": "npx",
      "args": ["-y", "hulihealth-mcp-dacs"],
      "env": {
        "HULIHEALTH_API_KEY": "YOUR-API-KEY",
        "HULI_ORG_ID": "YOUR-ORG-ID"
      }
    }
  }
}

---

🔑 Environment Variables

• HULIHEALTH_API_KEY – your API key (required)
• HULI_ORG_ID – your organization ID (required)
• PORT – optional port for SSE mode

---

Created by dacsdev.