Huly MCP
未认领Huly MCP and CLI: Feature-complete MCP server and CLI for Huly platform. Intabia partially compatible.
01 / 选择客户端
03 / 添加配置
claude mcp add --transport stdio 'huly-mcp' -- 'npx' '-y' '@firfi/huly-mcp@latest'04 / 在客户端中确认
打开客户端的 MCP 设置，确认服务器已连接并列出工具。复制配置不代表连接成功。
更多Automation服务器
浏览完整目录安全概况
已认领和已认证的服务器每周接受一次静态扫描，显示代码能触及的范围（外部服务、环境变量、shell 命令、代理配置目录）以及带有已知公告的依赖。认领此列表即可获得。 安全概况的工作原理
40 个工具中显示 40 个
文档中列出的工具 (40)
内容来自项目文档。服务器握手不会验证每个工具的说明或行为。
add_issue_label
Add a tag/label to a Huly issue. Creates the tag if it doesn't exist in the project.
add_issue_relation
Add a relation between two issues. Relation types: 'blocks' (source blocks target — pushes into target's blockedBy), 'is-blocked-by' (source is blocked by target — pushes into source's blockedBy), 'relates-to' (bidirectional link — updates both sides). targetIssue accepts cross-project identifiers l
add_template_child
Add a child (sub-task) template to an issue template. The child defines default values for sub-issues created when using createissuefromtemplate. Child description supports markdown. Markdown links to current-workspace Huly browse URLs with class, id, and label become native Huly references; externa
create_component
Create a new component in a Huly project. Components help organize issues by area/feature. Description supports markdown. Markdown links to current-workspace Huly browse URLs with class, id, and label become native Huly references; external URLs and other-workspace browse URLs stay normal links. Ret
create_issue
Create a new issue in a Huly project. Omit parentIssue for a native top-level issue, or specify parentIssue to create a sub-issue. Optionally set taskType by ID or display name; it is resolved within the target project's project type, and status is validated against that task type's workflow. Use li
create_issue_from_template
Create a new issue from a template. Applies template defaults, allowing overrides for specific fields. Description override supports markdown. Markdown links to current-workspace Huly browse URLs with class, id, and label become native Huly references; external URLs and other-workspace browse URLs s
create_issue_template
Create a new issue template in a Huly project. Templates define default values for new issues. Template and child descriptions support markdown. Markdown links to current-workspace Huly browse URLs with class, id, and label become native Huly references; external URLs and other-workspace browse URLs
create_project
Create a new Huly tracker project. Idempotent: returns existing project if one with the same identifier already exists (created=false). Identifier must be 1-5 uppercase alphanumeric chars starting with a letter.
delete_component
Permanently delete a Huly component. This action cannot be undone.
delete_issue
Permanently delete a Huly issue. This action cannot be undone.
delete_issue_template
Permanently delete a Huly issue template. This action cannot be undone.
delete_project
Permanently delete a Huly project. All issues, milestones, and components in this project will be orphaned. This action cannot be undone.
get_component
Retrieve full details for a Huly component. Use this to view component content and metadata.
get_issue
Retrieve full details for a Huly issue including markdown description, its creator as a stable Person reference { id, name?, email? } when resolvable, its assigned milestone as { id, label } when resolvable, and deterministic attached-label summaries with title and available color. Missing labels ar
get_issue_template
Retrieve full details for a Huly issue template including children (sub-task templates). Use this to view template content, default values, and child template IDs.
get_project
Get full details of a Huly project including its statuses. Returns project name, description, archived flag, default status, and all available statuses.
get_tool_schema
Returns the exact input and output schema for one proxy-visible Huly tool. Use this before invoketool when you are not certain about required argument names or result shape.
invoke_tool
Invokes one proxy-visible Huly tool by exact name with its arguments. This tool can call read or write Huly operations; check gettoolschema and the target tool annotations when safety matters.
link_document_to_issue
Link a Huly document to an issue. The link appears in the issue's Relations panel in the UI. Idempotent: no-op if the document is already linked. Use listissuerelations to see linked documents.
list_components
List components in a Huly project. Components organize issues by area/feature. Returns components sorted by modification date (newest first).
list_issue_relations
List all relations of an issue. Returns blockedBy (issues blocking this one), blocks (issues this one blocks), relations (bidirectional issue links), and documents (linked documents with title/teamspace).
list_issue_templates
List issue templates in a Huly project. Templates define reusable issue configurations. Returns templates sorted by modification date (newest first).
list_issues
Query Huly issues with optional filters. Returns issues sorted by modification date (newest first). Supports filtering by project, exact workflow status name (status), Huly SDK task.statusCategory key (statusCategory: UnStarted, ToDo, Active, Won, Lost), assignee, creator (raw Person ID, exact email
list_project_target_preferences
List low-level per-project tracker target preference records. These Huly ProjectTargetPreference records are attached to projects and used by tracker UI/workflows to remember target-related preference props. Omit project to list recent preferences across projects, or pass a project identifier to ins
list_projects
List all Huly projects. Returns projects sorted by name. Supports filtering by archived status.
list_statuses
List all issue statuses for a Huly project with workflow category and default info. Returns status name, category, and isDefault. Use this to discover valid statuses before creating or updating issues.
list_tool_categories
Lists Huly tool categories available through this proxy. Use this first when you need a broad map of capabilities before searching for a specific Huly tool.
move_issue
Move an issue to a new parent (making it a sub-issue), or pass null to restore its native top-level shape. Updates parent/child relationships and sub-issue counts.
preview_deletion
Preview the impact of deleting a Huly entity before actually deleting it. Shows affected sub-entities, relations, and warnings. Supports issues, projects, components, and milestones. Use this to understand cascade effects before calling a delete operation.
remove_issue_label
Remove a tag/label from a Huly issue. Detaches the label reference; does not delete the label definition.
remove_issue_relation
Remove a relation between two issues. Mirrors addissuerelation: 'blocks' pulls from target's blockedBy, 'is-blocked-by' pulls from source's blockedBy, 'relates-to' pulls from both sides. No-op if the relation doesn't exist.
remove_template_child
Remove a child (sub-task) template from an issue template by its child ID. Get child IDs from getissuetemplate response.
search_tools
Searches the current proxy-visible Huly tool catalog by tool name, category, description, and parameter names. Returns exact tool names plus required and optional parameter names for single-call follow-up with gettoolschema or invoketool.
set_issue_component
Set or clear the component on a Huly issue. Pass null for component to clear it.
unlink_document_from_issue
Remove a document link from an issue. Idempotent: no-op if the document is not linked.
update_component
Update fields on an existing Huly component. Only provided fields are modified. Description supports markdown. Markdown links to current-workspace Huly browse URLs with class, id, and label become native Huly references; external URLs and other-workspace browse URLs stay normal links.
update_issue
Update fields on an existing Huly issue. Optionally set taskType by ID or display name; it is resolved within the target project's project type, and the status is preserved only when valid for the new task type. Use listtasktypes or getprojecttype to discover valid task types and statuses. Only prov
update_issue_template
Update fields on an existing Huly issue template. Only provided fields are modified. Description supports markdown. Markdown links to current-workspace Huly browse URLs with class, id, and label become native Huly references; external URLs and other-workspace browse URLs stay normal links.
update_project
Update a Huly project. Only provided fields are modified. Set description to null to clear it.
upsert_project_target_preference
Create or update the low-level ProjectTargetPreference record for a project. This refreshes usedOn and merges SDK-open target preference props by key. Use for tracker SDK parity or advanced administration; ordinary project and issue workflows usually do not need this tool.