{"_id":"@armoe/huly-mcp-server","_rev":"3-eda0447e614a6d5c04b16cce422a25e0","name":"@armoe/huly-mcp-server","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@armoe/huly-mcp-server","version":"0.1.0","keywords":["mcp","huly","model-context-protocol"],"license":"GPL-3.0-only","_id":"@armoe/huly-mcp-server@0.1.0","maintainers":[{"name":"realheart","email":"qgzhenxin@qq.com"}],"homepage":"https://github.com/armoe-project/huly-mcp-server#readme","bugs":{"url":"https://github.com/armoe-project/huly-mcp-server/issues"},"dist":{"shasum":"25dc0d1c4227d53865caeb88fcc977fca6dec0c8","tarball":"https://registry.npmjs.org/@armoe/huly-mcp-server/-/huly-mcp-server-0.1.0.tgz","fileCount":16,"integrity":"sha512-xnDARhXZu6PIthT2f/WQ0rKesYR9o7srZzjc0w/k8QplOCP2S33sefMZfTZg8CIAdU4wNiV1XT9WYxCQYEzs6A==","signatures":[{"sig":"MEUCIQDBZUMP8Z1VCjpsnGCHd3Zx7IsgvZYPTHOi4wt0CAAzzAIgRgeQy06VYJ7HPvZYsIoU8m7jhpvhAgFJUSXOIVx5WuM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102052},"main":"src/index.ts","type":"module","module":"src/index.ts","engines":{"bun":">=1.3.0"},"gitHead":"4629ebf3acece7a73544ffeb9a95dbc1f75252c6","private":false,"scripts":{"dev":"bun run --watch src/index.ts","lint":"biome check .","start":"bun run src/index.ts","format":"biome format --write .","lint:fix":"biome check --write .","typecheck":"tsc --noEmit"},"_npmUser":{"name":"realheart","email":"qgzhenxin@qq.com"},"repository":{"url":"git+https://github.com/armoe-project/huly-mcp-server.git","type":"git"},"_npmVersion":"11.6.4","description":"MCP Server for Huly integration","directories":{},"_nodeVersion":"24.11.1","dependencies":{"ws":"^8.19.0","zod":"^4.3.5","@hcengineering/core":"^0.7.23","@hcengineering/rank":"^0.7.17","@hcengineering/tags":"^0.7.0","@hcengineering/task":"^0.7.0","@hcengineering/contact":"^0.7.0","@hcengineering/tracker":"^0.7.0","@hcengineering/document":"^0.7.0","@hcengineering/api-client":"^0.7.18","@modelcontextprotocol/sdk":"^1.25.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.3.5","typescript":"^5.9.3","@biomejs/biome":"^2.3.11"},"_npmOperationalInternal":{"tmp":"tmp/huly-mcp-server_0.1.0_1769669960726_0.8625612299627734","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@armoe/huly-mcp-server","version":"0.1.1","keywords":["mcp","huly","model-context-protocol"],"license":"GPL-3.0-only","_id":"@armoe/huly-mcp-server@0.1.1","maintainers":[{"name":"realheart","email":"qgzhenxin@qq.com"}],"homepage":"https://github.com/armoe-project/huly-mcp-server#readme","bugs":{"url":"https://github.com/armoe-project/huly-mcp-server/issues"},"bin":{"huly-mcp-server":"bin/huly-mcp-server"},"dist":{"shasum":"88b8ac7a49aa0d6e2e015ba88073edfd5e2fa227","tarball":"https://registry.npmjs.org/@armoe/huly-mcp-server/-/huly-mcp-server-0.1.1.tgz","fileCount":17,"integrity":"sha512-JEAI7PBbeDCSakMz7E1aNuvmeYiP2jkGz7hQes/U6FjGL1GVLflrigTvlnIVDFDd83EynPuiiPM7MXByzd7OeQ==","signatures":[{"sig":"MEQCIAG+IJGA5ZFRwFVC44WDHgwUnCXZDqil1firNtPOcWC+AiBujtIFneLKasSy/w4hFGlYU1Gsk2k0XRo3pS0vFJjAtg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":103027},"main":"src/index.ts","type":"module","module":"src/index.ts","engines":{"bun":">=1.3.0"},"gitHead":"bfa0216e1d3c6082ecf0fe72ce5698c56e9d8ded","private":false,"scripts":{"dev":"bun run --watch src/index.ts","lint":"biome check .","start":"bun run src/index.ts","format":"biome format --write .","lint:fix":"biome check --write .","typecheck":"tsc --noEmit"},"_npmUser":{"name":"realheart","email":"qgzhenxin@qq.com"},"repository":{"url":"git+https://github.com/armoe-project/huly-mcp-server.git","type":"git"},"_npmVersion":"11.6.4","description":"MCP Server for Huly integration","directories":{},"_nodeVersion":"24.11.1","dependencies":{"ws":"^8.19.0","zod":"^4.3.5","@hcengineering/core":"^0.7.23","@hcengineering/rank":"^0.7.17","@hcengineering/tags":"^0.7.0","@hcengineering/task":"^0.7.0","@hcengineering/contact":"^0.7.0","@hcengineering/tracker":"^0.7.0","@hcengineering/api-client":"^0.7.18","@modelcontextprotocol/sdk":"^1.25.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"^1.3.5","typescript":"^5.9.3","@biomejs/biome":"^2.3.11"},"_npmOperationalInternal":{"tmp":"tmp/huly-mcp-server_0.1.1_1769671975687_0.6900535022991001","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@armoe/huly-mcp-server","version":"0.1.2","description":"MCP Server for Huly integration","type":"module","module":"src/index.ts","main":"src/index.ts","private":false,"publishConfig":{"access":"public"},"scripts":{"dev":"bun run --watch src/index.ts","start":"bun run src/index.ts","typecheck":"tsc --noEmit","lint":"biome check .","lint:fix":"biome check --write .","format":"biome format --write ."},"engines":{"bun":">=1.3.0"},"keywords":["mcp","huly","model-context-protocol"],"license":"GPL-3.0-only","bin":{"huly-mcp-server":"bin/huly-mcp-server"},"repository":{"type":"git","url":"git+https://github.com/armoe-project/huly-mcp-server.git"},"bugs":{"url":"https://github.com/armoe-project/huly-mcp-server/issues"},"homepage":"https://github.com/armoe-project/huly-mcp-server#readme","dependencies":{"@hcengineering/api-client":"^0.7.18","@hcengineering/contact":"^0.7.0","@hcengineering/core":"^0.7.23","@hcengineering/rank":"^0.7.17","@hcengineering/tags":"^0.7.0","@hcengineering/task":"^0.7.0","@hcengineering/tracker":"^0.7.0","@modelcontextprotocol/sdk":"^1.25.1","ws":"^8.19.0","zod":"^4.3.5"},"devDependencies":{"@biomejs/biome":"^2.3.11","@types/bun":"^1.3.5","typescript":"^5.9.3"},"gitHead":"c7a52093d61cb1f39d799ee6137ebeded4cc9872","_id":"@armoe/huly-mcp-server@0.1.2","_nodeVersion":"24.11.1","_npmVersion":"11.6.4","dist":{"integrity":"sha512-X0I/srIrvUyAC0U800MnDUK0Rettu3c31u4VtvOKkb6/MOXKFJAKNUflLoL7wwftGh9GdC+JQfs/6Ps3xdNbnQ==","shasum":"05435cea7c5952b7fe08dc545980bc3aa5f18a10","tarball":"https://registry.npmjs.org/@armoe/huly-mcp-server/-/huly-mcp-server-0.1.2.tgz","fileCount":18,"unpackedSize":109602,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDqU92hOu2QDsxeCM9KcuySyW1jCcxMC93uuUKKO8t9rwIgA9XnYcFFFxlXAeLqa+8exj1HMkM1JSk2XLO854e8rf8="}]},"_npmUser":{"name":"realheart","email":"qgzhenxin@qq.com"},"directories":{},"maintainers":[{"name":"realheart","email":"qgzhenxin@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/huly-mcp-server_0.1.2_1769683572915_0.6212597263988113"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-29T06:59:20.593Z","modified":"2026-01-29T10:46:13.202Z","0.1.0":"2026-01-29T06:59:20.867Z","0.1.1":"2026-01-29T07:32:55.835Z","0.1.2":"2026-01-29T10:46:13.057Z"},"bugs":{"url":"https://github.com/armoe-project/huly-mcp-server/issues"},"license":"GPL-3.0-only","homepage":"https://github.com/armoe-project/huly-mcp-server#readme","keywords":["mcp","huly","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/armoe-project/huly-mcp-server.git"},"description":"MCP Server for Huly integration","maintainers":[{"name":"realheart","email":"qgzhenxin@qq.com"}],"readme":"# Huly MCP Server\n\n[Model Context Protocol](https://modelcontextprotocol.io) server for connecting to [Huly](https://huly.app) project management platform.\n\n## Features\n\n### Issue Management\n- `list_issues` - List project issues\n- `get_issue` - Get issue details\n- `create_issue` - Create new issue\n- `update_issue` - Update issue\n- `delete_issue` - Delete issue\n- `set_assignee` - Set assignee\n- `set_milestone` - Set milestone\n\n### Project Management\n- `list_projects` - List all projects\n- `get_project` - Get project details\n\n### Milestone Management\n- `list_milestones` - List project milestones\n- `get_milestone` - Get milestone details\n- `create_milestone` - Create new milestone\n- `delete_milestone` - Delete milestone\n\n### Contact Management\n- `list_persons` - List all contacts\n- `get_person` - Get contact details\n\n### Label Management\n- `add_label` - Add label to issue\n- `remove_label` - Remove label from issue\n- `list_labels` - List all available labels\n- `create_label` - Create new label\n- `delete_label` - Delete label\n\n### Relations\n- `add_relation` - Add issue relation\n- `add_blocked_by` - Add dependency\n- `set_parent` - Set parent issue (subtask)\n\n### Metadata Queries\n- `list_task_types` - List task types\n- `list_statuses` - List all statuses\n\n## Configuration\n\n### Getting Credentials\n\n1. **Workspace**: Workspace identifier (e.g. `my-company` from `https://huly.app/my-company`)\n2. **Email/Password**: Your Huly account credentials\n\n### Environment Variables\n\n```bash\n# Required\nHULY_WORKSPACE=your-workspace-identifier\nHULY_EMAIL=your-email@example.com\nHULY_PASSWORD=your-password\n\n# Optional (default: https://huly.app)\nHULY_URL=https://huly.app\n```\n\n### CC-Switch\n\nIn CC-Switch, click the \"MCP\" button in the top-right corner:\n\n1. Click \"Add Server\"\n2. Configure:\n   - **Name**: `huly`\n   - **Transport**: `stdio`\n   - **Command**: `bunx`\n   - **Args**: `[\"@armoe/huly-mcp-server@latest\"]`\n   - **Environment**:\n     ```\n     HULY_WORKSPACE=your-workspace\n     HULY_EMAIL=your-email@example.com\n     HULY_PASSWORD=your-password\n     ```\n3. Enable the server to sync to applications\n\n### Cherry Studio\n\nIn Cherry Studio settings, add a new MCP server:\n\n```json\n{\n  \"name\": \"huly\",\n  \"command\": \"bunx\",\n  \"args\": [\"@armoe/huly-mcp-server@latest\"],\n  \"env\": {\n    \"HULY_WORKSPACE\": \"your-workspace\",\n    \"HULY_EMAIL\": \"your-email@example.com\",\n    \"HULY_PASSWORD\": \"your-password\"\n  }\n}\n```\n\n### Claude Desktop\n\nAdd to `~/.claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"huly\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@armoe/huly-mcp-server@latest\"],\n      \"env\": {\n        \"HULY_WORKSPACE\": \"your-workspace\",\n        \"HULY_EMAIL\": \"your-email@example.com\",\n        \"HULY_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd to `.claude/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"huly\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@armoe/huly-mcp-server@latest\"],\n      \"env\": {\n        \"HULY_WORKSPACE\": \"your-workspace\",\n        \"HULY_EMAIL\": \"your-email@example.com\",\n        \"HULY_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to VSCode settings (`settings.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"huly\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@armoe/huly-mcp-server@latest\"],\n      \"env\": {\n        \"HULY_WORKSPACE\": \"your-workspace\",\n        \"HULY_EMAIL\": \"your-email@example.com\",\n        \"HULY_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### Cline (VSCode Extension)\n\nAdd to VSCode settings:\n\n```json\n{\n  \"cline.mcpServers\": {\n    \"huly\": {\n      \"command\": \"bunx\",\n      \"args\": [\"@armoe/huly-mcp-server@latest\"],\n      \"env\": {\n        \"HULY_WORKSPACE\": \"your-workspace\",\n        \"HULY_EMAIL\": \"your-email@example.com\",\n        \"HULY_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n## Installation\n\n### Prerequisites\n\n- [Bun](https://bun.sh) >= 1.3.0\n\n### From npm (Recommended)\n\n```bash\nbunx @armoe/huly-mcp-server@latest\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/armoe/huly-mcp-server.git\ncd huly-mcp-server\nbun install\n```\n\n## Usage\n\n### Standalone\n\n```bash\n# Set environment variables\nexport HULY_WORKSPACE=your-workspace\nexport HULY_EMAIL=your-email@example.com\nexport HULY_PASSWORD=your-password\n\n# Run server\nbun run src/index.ts\n```\n\n### Development Mode\n\n```bash\nbun run dev\n```\n\n## Development\n\n```bash\n# Type check\nbun run typecheck\n\n# Lint\nbun run lint\n\n# Auto-fix formatting\nbun run lint:fix\n\n# Format\nbun run format\n```\n\n## Project Structure\n\n```\nhuly-mcp-server/\n├── src/\n│   ├── client.ts          # Huly API client\n│   ├── config.ts          # Configuration loading\n│   ├── index.ts           # Server entry\n│   ├── tools/             # MCP tools implementation\n│   │   ├── issue.ts       # Issue related tools\n│   │   ├── label.ts       # Label related tools\n│   │   ├── labelExtended.ts # Extended label and relation tools\n│   │   ├── milestone.ts   # Milestone related tools\n│   │   ├── person.ts      # Contact related tools\n│   │   └── project.ts     # Project related tools\n│   └── utils/             # Utility functions\n│       └── converters.ts  # Type conversion functions\n├── .mcp.json.example      # MCP configuration template\n└── package.json\n```\n\n## License\n\nGPL-3.0-only\n\n## Related Links\n\n- [Model Context Protocol](https://modelcontextprotocol.io)\n- [Huly Platform](https://huly.app)\n","readmeFilename":"README.md"}