Skip to main content
Glama
hha-nguyen

Huly MCP Server

by hha-nguyen
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Hybrid

Huly MCP Server

Custom MCP server for Huly workspace built from scratch. Runs on your remote server and connects to Huly WebSocket API.

Features

  • ✅ Built from scratch - No dependencies on buggy huly-mcp package

  • ✅ Fixes all bugs - Correct attachedToClass, collection, and kind fields

  • ✅ Auto-resolves project kind IDs - Automatically gets correct task type for each project

  • ✅ Runs on remote server - Deploy on your server where Huly is hosted

  • ✅ Connects via SSH - Cursor connects via SSH to remote server

Installation on Remote Server

cd /path/to/huly-mcp-server npm install npm run build

Configuration

Create .env file or set environment variables:

HULY_URL=https://workspace.teasersoftware.com HULY_EMAIL=your-email@example.com HULY_PASSWORD=your-password HULY_WORKSPACE=Teaser Software PORT=3000

Running the Server

On Remote Server

npm start # or for development npm run dev

The server uses stdio transport (standard MCP protocol).

Connecting from Cursor

For HTTP Server (Remote)

Add to Cursor Settings → MCP Servers:

{ "mcpServers": { "huly-remote": { "url": "http://your-server-ip:3000/mcp", "env": { "HULY_URL": "https://workspace.teasersoftware.com", "HULY_EMAIL": "your-email@example.com", "HULY_PASSWORD": "your-password" } } } }

For Stdio Server (Local)

{ "mcpServers": { "huly-local": { "command": "node", "args": ["/absolute/path/to/huly-mcp-server/dist/index.js"], "env": { "HULY_URL": "https://workspace.teasersoftware.com", "HULY_EMAIL": "your-email@example.com", "HULY_PASSWORD": "your-password" } } } }

How It Works

  1. Connects to Huly: Uses WebSocket API to connect to your Huly workspace

  2. Resolves Project IDs: Automatically converts project names to space IDs

  3. Gets Correct Kind ID: Queries existing issues to get the correct task type ID for each project

  4. Creates Issues Correctly: Sets all fields correctly:

    • attachedToClass: "tracker:class:Issue"

    • collection: "subIssues"

    • kind: <project-specific-id>

Available Tools

  • create_issue - Create issues with correct fields

  • list_issues - List issues from projects

  • list_projects - List all projects

Development

npm run dev:http # Run HTTP server in development npm run dev # Run stdio server in development npm run build # Build TypeScript

Deployment on Remote Server

1. Copy to Server

scp -r huly-mcp-server user@your-server:/opt/huly-mcp-server

2. Install and Build

ssh user@your-server cd /opt/huly-mcp-server npm install npm run build

3. Create .env File

cat > .env << EOF HULY_URL=https://workspace.teasersoftware.com HULY_EMAIL=hha.nguyen298@gmail.com HULY_PASSWORD=Ha@29082002 HULY_WORKSPACE=Teaser Software EOF

4. Test Locally on Server

node dist/index.js # Should see: "Huly MCP Server running on stdio"

The server is ready! Cursor will connect via SSH.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hha-nguyen/huly-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server