# 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
```bash
cd /path/to/huly-mcp-server
npm install
npm run build
```
## Configuration
Create `.env` file or set environment variables:
```bash
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
```bash
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:
```json
{
"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)
```json
{
"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
```bash
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
```bash
scp -r huly-mcp-server user@your-server:/opt/huly-mcp-server
```
### 2. Install and Build
```bash
ssh user@your-server
cd /opt/huly-mcp-server
npm install
npm run build
```
### 3. Create .env File
```bash
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
```bash
node dist/index.js
# Should see: "Huly MCP Server running on stdio"
```
The server is ready! Cursor will connect via SSH.
