HISE MCP Server

HISE MCP Server

A Model Context Protocol (MCP) server for querying HISE documentation, including UI component properties, Scripting API methods, module parameter IDs, and a best-practice code snippet database.

Requirements

• Node.js 18+ (Required - not compatible with older versions)
• npm or yarn

Features

• Exact Query Tools: Look up specific UI component properties, Scripting API methods, and module parameters with precise matching
• Code Snippet Database: Browse and retrieve 100-150 code examples organized by metadata (category, tags, difficulty)
• Best Practice Guide: Code snippets serve as a reference for AI agents implementing HISE solutions
• Fast Lookups: Indexed data structures for O(1) exact queries
• Type-Safe: Full TypeScript implementation

Available Tools

Exact Query Tools

1. query_ui_property - Query UI component properties

   • Input: componentType, propertyName
   • Returns: Property details including type, default value, description, and possible values

2. query_scripting_api - Query Scripting API methods

   • Input: namespace, methodName
   • Returns: Method signature, parameters, return type, description, and example usage

3. query_module_parameter - Query module parameter IDs

   • Input: moduleType, parameterId
   • Returns: Parameter details including min/max values, step size, default value, and description

Code Snippet Tools

4. list_snippets - List all available code snippets with metadata

   • Input: none
   • Returns: Array of snippet summaries (id, title, description, category, tags, difficulty)
   • Use this first to browse and discover relevant snippets

5. get_snippet - Get full details and code for a specific snippet

   • Input: id (snippet ID from list_snippets)
   • Returns: Complete snippet with code, related APIs, and components

Listing Tools

6. list_ui_components - List all available UI component types
7. list_scripting_namespaces - List all available Scripting API namespaces
8. list_module_types - List all available module types

Installation

Check Node.js Version

First, verify your Node.js version:

node --version

If you have Node.js < 18, you must upgrade. Use one of these methods:

Option 1: Using nvm (recommended on macOS/Linux):

nvm install 20
nvm use 20

Option 2: Using nvm-windows (recommended on Windows):

1. Download nvm-windows from: https://github.com/coreybutler/nvm-windows/releases
2. Install it, then run:

nvm install 20
nvm use 20

Option 3: Direct download: Download the LTS version from: https://nodejs.org/

Setup

1. Clone or download this repository

2. Install dependencies:

npm install

3. Build the project and configure opencode (recommended):

npm run build:configure

This will:

• Compile TypeScript to JavaScript
• Automatically find and update your opencode config file
• Add the HISE MCP server entry with the correct absolute path

Or manually build only:

npm run build

4. Set up environment variables:

# Optional: Custom path to HISE data JSON file
# Default: ./data/hise-data.json
export HISE_DATA_PATH="/path/to/your/hise-data.json"

On Windows (Command Prompt):

set HISE_DATA_PATH=C:\path\to\hise-data.json

On Windows (PowerShell):

$env:HISE_DATA_PATH="C:\path\to\hise-data.json"

Usage

Running the Server

npm start

The server will start and listen for MCP connections via stdio.

Using with Claude Desktop

Add the HISE MCP server configuration to your Claude Desktop config file.

Finding the Config File

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json (usually C:\Users\<username>\AppData\Roaming\Claude\)

Configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "hise": {
      "command": "node",
      "args": ["D:\\development\\projekte\\hise_mcp\\dist\\index.js"],
      "env": {
        "HISE_DATA_PATH": "D:\\development\\projekte\\hise_mcp\\data\\hise-data.json"
      }
    }
  }
}

Important: Replace the paths with your actual installation path. Use absolute paths (not relative).

Restart Claude Desktop

After adding the configuration, completely quit and restart Claude Desktop to load the MCP server.

Verification

Once connected, you can verify the server is working by asking Claude:

List all available tools from the HISE MCP server

Using with Opencode

The easiest way to configure Opencode is to use the automated script:

npm run build:configure

This will:

• Build the TypeScript project
• Find your opencode config file automatically
• Add or update the HISE MCP server entry with the correct absolute path
• Create the config directory if it doesn't exist

After running, restart Op