使用说明
Huly MCP Server
Model Context Protocol server for Huly workspace management.
116 tools for project management, documents, cards, messaging, calendar, and more.
Built for Remi.
需求
- Node.js>=20
- pnpm
- 具有API访问权限的正在运行的Huly实例
设置
pnpm install
cp .env.example .env
# Edit .env with your Huly credentials
配置
| 变量 | 描述 |
|---|---|
HULY_URL |
Huly实例URL（例如。 https://huly.example.com) |
HULY_EMAIL |
帐户电子邮件 |
HULY_PASSWORD |
帐户密码 |
HULY_WORKSPACE |
工作区标识符 |
LOG_LEVEL |
日志记录级别： debug, info, warn, error （默认值： info) |
跑步
pnpm start
码头工人
docker build -t huly-mcp-server .
docker run --env-file .env huly-mcp-server
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"huly": {
"command": "npx",
"args": ["tsx", "src/index.ts"],
"cwd": "/path/to/huly-mcp-server",
"env": {
"HULY_URL": "https://huly.example.com",
"HULY_EMAIL": "your-email@example.com",
"HULY_PASSWORD": "your-password",
"HULY_WORKSPACE": "your-workspace"
}
}
}
}
可用工具（116）
问题与项目（15）
list_projects-列出所有项目list_issues-列出可选筛选器的问题get_issue-获取完整的问题详细信息和描述create_issue-创建新问题update_issue-更新现有问题delete_issue-删除问题add_comment-向问题添加评论search_issues-按文本查询搜索问题add_issue_label-为问题添加标签list_issue_templates-列出问题模板get_issue_template-获取模板详细信息create_issue_template-创建问题模板update_issue_template-更新问题模板delete_issue_template-删除问题模板create_issue_from_template-使用模板默认值创建问题
组织（1）
list_statuses-列出项目的问题状态
组件（5）
list_components-列出项目组件get_component-获取组件详细信息create_component-创建组件update_component-更新组件delete_component-删除组件
里程碑（5）
list_milestones-列出项目里程碑get_milestone-获取里程碑详细信息create_milestone-创建里程碑update_milestone-更新里程碑delete_milestone-删除里程碑
卡片（6）
list_card_spaces-列出所有卡空间list_cards-列出带有可选空间过滤器的卡片get_card-获取完整的卡详细信息create_card-创建新卡update_card-更新卡片delete_card-删除卡片
文件（6）
list_teamspaces-列出所有团队空间list_documents-列出具有可选团队空间筛选器的文档get_document-获取包含内容的完整文档create_document-创建新文档update_document-更新文档delete_document-删除文档
附件（7）
list_attachments-列出问题或卡片上的附件get_attachment-获取附件详细信息add_attachment-向对象添加附件update_attachment-更新附件元数据delete_attachment-删除附件pin_attachment-固定或取消固定附件download_attachment-获取附件的下载信息
评论（3）
list_comments-列出对象的注释update_comment-更新评论delete_comment-删除评论
搜索（1）
fulltext_search-在所有工作区对象中搜索
联系人（8）
list_persons-列出所有人员get_person-获取人员详细信息create_person-创建一个人update_person-更新一个人delete_person-删除一个人list_employees-列出在职员工list_organizations-列出组织create_organization-创建一个组织
存储（1）
upload_file-将文件上传到工作区
频道（11）
list_channels-列出所有频道get_channel-获取频道详细信息create_channel-创建频道update_channel-更新频道delete_channel-删除频道list_channel_messages-列出频道中的消息send_channel_message-向频道发送消息list_direct_messages-列出直接消息对话list_thread_replies-在一个帖子中列出回复add_thread_reply-向帖子添加回复delete_thread_reply-删除帖子回复
时间追踪（8）
log_time-记录在问题上花费的时间get_time_report-获取时间花费报告list_time_spend_reports-列出带过滤器的时间报告get_detailed_time_report-获取项目的汇总时间报告list_work_slots-列出工作槽create_work_slot-创建工作槽start_timer-为问题启动计时器stop_timer-停止计时器
日历（8）
list_events-列出日历事件get_event-获取活动详细信息create_event-创建日历事件update_event-更新日历事件delete_event-删除日历事件list_recurring_events-列出重复事件create_recurring_event-创建重复事件list_event_instances-列出重复事件的实例
活动（8）
list_activity-列出对象的活动消息add_reaction-添加表情符号反应remove_reaction-删除表情符号反应list_reactions-列出对消息的反应save_message-保存消息以备后用unsave_message-删除已保存的邮件list_saved_messages-列出已保存的邮件list_mentions-列出用户提及
通知（13）
list_notifications-列出收件箱通知get_notification-获取通知详细信息mark_notification_read-将通知标记为已读mark_all_notifications_read-将所有内容标记为已读archive_notification-将通知存档archive_all_notifications-将所有通知存档delete_notification-删除通知get_notification_context-获取通知上下文list_notification_contexts-列出通知上下文pin_notification_context-固定/取消固定通知上下文list_notification_settings-列出通知设置update_notification_provider_setting-更新通知提供程序设置get_unread_notification_count-获取未读计数
工作区（10）
list_workspace_members-列出工作区成员update_member_role-更新成员的角色get_workspace_info-获取工作区信息list_workspaces-列出可用工作区create_workspace-创建工作区delete_workspace-删除工作区get_user_profile-获取当前用户配置文件update_user_profile-更新用户配置文件update_guest_settings-更新访客访问设置get_regions-获取可用区域
测试
pnpm test
pnpm test:coverage
许可证
ISC
