mcp-openhexa

A VERY rudimentary proof of concept of a local MCP server for OpenHEXA using Claude Desktop

Setup guide

Installing via Smithery

To install mcp-openhexa for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @mcrimi/mcp-openhexa --client claude

1. Setup .venv and install Dependencies

pip install -r requirements.txt

2. Configure Claude Desktop

1. Edit your Claude Desktop configuration file:

   • macOS: /Users/{youruser}/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add or merge the configuration from claude_desktop_config.json:

{
  "mcpServers": {
    "openhexa": {
      "command": "{path}/mcp-openhexa/.venv/bin/python",
      "args": ["-m", "mcp_openhexa.server"],
      "cwd": "{path}/mcp-openhexa",
      "env": {
        "HEXA_TOKEN": "{YOUR TOKEN HERE}",
        "HEXA_SERVER_URL": "https://app.openhexa.org/"
      }
    }
  }
} 

3. Replace the placeholder values with URL and OpenHEXA token

4. Restart Claude Desktop

5. You should now see OpenHEXA as an integration tool:

3. Start Using with Claude

Once configured, you can ask Claude questions like:

• "Show me all workspaces in OpenHEXA"

• "List datasets in the 'public-health' workspace"

• "Search for pipelines containing 'analysis' in their name"

• "Get details about the 'covid-data' dataset"

• "Show recent runs for the 'data-processing' pipeline"