HacknPlan MCP服务器
将Claude直接连接到您的 HacknPlan 游戏开发项目。
设置
1.获取API密钥
- 登录HacknPlan
- 首选 个人资料→ 设置→ API测试版→ 创建
- 命名（例如。
claude-mcp)，选择所需的范围，单击 创建 - 复制密钥
2.安装依赖项
npm install
3.配置克劳德桌面
将此添加到您的 claude_desktop_config.json:
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json\ 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"hacknplan": {
"command": "node",
"args": ["/absolute/path/to/hacknplan-mcp/index.js"],
"env": {
"HACKNPLAN_API_KEY": "your_api_key_here"
}
}
}
}
4.重新启动克劳德桌面
可用工具
项目
| 工具 | 说明 |
|---|
list_projects | 列出工作区中的所有项目 |
get_project | 获取项目详细信息 |
create_project | 创建新项目(costMetric 必修的： "points" 或 "hours") |
update_project | 部分更新项目名称或描述（PATCH） |
replace_project | 完全替换项目（PUT） |
delete_project | 永久删除项目 |
close_project | 存档（关闭）项目 |
reopen_project | 重新打开已关闭的项目 |
get_project_metrics | 获取项目的进度和燃尽指标 |
change_project_owner | 将项目所有权转移给另一个用户 |
板子
| 工具 | 说明 |
|---|
list_boards | 列出项目中的公告板（可选包括已关闭的公告板） |
get_board | 获取电路板详细信息 |
create_board | 创建新板（可选择附加到里程碑） |
update_board | 部分更新电路板（PATCH） |
replace_board | 完全更换电路板（PUT） |
delete_board | 永久删除板（可选删除工作项） |
close_board | 将板存档（关闭） |
reopen_board | 重新打开一个封闭的板 |
get_board_metrics | 获取电路板的进度和烧毁指标 |
set_default_board | 为项目设置默认板 |
clear_default_board | 删除默认板设置 |
里程碑
| 工具 | 说明 |
|---|
list_milestones | 列出项目中的里程碑 |
get_milestone | 获取里程碑详细信息（可选嵌入板） |
create_milestone | 创建具有可选日期的里程碑 |
update_milestone | 部分更新里程碑（PATCH） |
replace_milestone | 完全替换里程碑（PUT） |
delete_milestone | 永久删除里程碑（可选级联到板/工作项） |
close_milestone | 标记里程碑完成 |
reopen_milestone | 重新打开已关闭的里程碑 |
get_milestone_metrics | 获取里程碑的进度和燃尽指标 |
工作项
| 工具 | 说明 |
|---|
list_work_items | 列出带有过滤器的工作项（板、里程碑、阶段、类别、用户、完成、搜索、排序） |
get_work_item | 获取完整的工作项详细信息 |
create_work_item | 创建一个包含标题、描述、优先级、受让人、估计、截止日期、标签的任务 |
update_work_item | 更新工作项（PATCH）上的任何字段 |
clone_work_item | 创建现有工作项的副本 |
delete_work_item | 删除工作项 |
list_work_item_attachments | 列出工作项上的附件 |
get_work_item_attachment | 获取特定工作项附件 |
delete_work_item_attachment | 删除工作项附件 |
分类
| 工具 | 说明 |
|---|
list_categories | 列出项目中的工作项类别 |
get_category | 获取类别详细信息 |
create_category | 创建新类别 |
update_category | 部分更新类别（PATCH） |
delete_category | 删除类别 |
阶段
| 工具 | 说明 |
|---|
list_stages | 列出项目中的工作流阶段 |
get_stage | 获取舞台细节 |
create_stage | 创建新舞台 |
update_stage | 部分更新阶段（PATCH） |
delete_stage | 删除阶段 |
重要性级别
| 工具 | 说明 |
|---|
list_importance_levels | 列出项目中的重要性级别 |
get_importance_level | 获取重要性级别详细信息 |
create_importance_level | 创建新的重要性级别 |
update_importance_level | 部分更新重要性级别（PATCH） |
delete_importance_level | 删除重要级别 |
用户和角色
| 工具 | 说明 |
|---|
get_current_user | 获取您自己的用户信息 |
list_project_users | 列出项目中的用户 |
get_project_user | 获取特定用户的项目成员资格 |
add_project_user | 将用户添加到项目中 |
update_project_user | 部分更新用户的项目成员资格（PATCH） |
replace_project_user | 完全替换用户的项目成员资格（PUT） |
add_team_to_project | 将整个团队添加到项目中 |
list_project_roles | 列出项目中的角色 |
get_project_role | 获得特定角色 |
create_project_role | 创建新角色 |
update_project_role | 部分更新角色（PATCH） |
replace_project_role | 完全替换角色（PUT） |
delete_project_role | 删除角色 |
标签
| 工具 | 说明 |
|---|
list_project_tags | 列出项目中的标记 |
create_project_tag | 创建新标签（可选十六进制颜色） |
update_project_tag | 部分更新标签（PATCH） |
replace_project_tag | 完全替换标签（PUT） |
delete_project_tag | 删除标签 |
设计元素（GDD）
| 工具 | 说明 |
|---|
list_design_elements | 列出项目中的设计元素（GDD文档） |
get_design_element | 获取设计元素详细信息 |
create_design_element | 创建新的设计元素 |
update_design_element | 部分更新设计元素（PATCH） |
replace_design_element | 完全替换设计元素（PUT） |
delete_design_element | 删除设计元素 |
get_design_element_metrics | 获取设计元素的指标 |
list_design_element_types | 列出项目中的设计元素类型 |
get_design_element_type | 获取特定的设计元素类型 |
create_design_element_type | 创建新的设计元素类型 |
update_design_element_type | 部分更新设计元素类型（PATCH） |
replace_design_element_type | 完全替换设计元素类型（PUT） |
delete_design_element_type | 删除设计元素类型 |
list_design_element_attachments | 列出设计元素上的附件 |
get_design_element_attachment | 获取特定的设计元素附件 |
delete_design_element_attachment | 删除设计元素附件 |
list_design_element_comments | 列出对设计元素的评论 |
create_design_element_comment | 向设计元素添加注释 |
update_design_element_comment | 更新设计元素注释（PUT） |
delete_design_element_comment | 删除设计元素注释 |
事件、文件和Webhooks
| 工具 | 说明 |
|---|
list_project_events | 列出项目的活动事件 |
list_project_files | 列出存储在项目中的文件 |
delete_project_file | 从项目中删除文件 |
get_project_storage | 获取文件存储配额和使用情况 |
list_webhook_event_types | 列出所有可用的webhook事件类型 |
list_webhooks | 列出为项目配置的Webhook |
create_webhook | 为项目创建webhook |
get_webhook | 获取webhook详细信息 |
update_webhook | 部分更新webhook（PATCH） |
replace_webhook | 完全替换webhook（PUT） |
delete_webhook | 删除webhook |
示例提示
- *“显示我的迷宫赛车项目中的所有工作项”*
- *在编程板中创建一个名为“实施排行榜”的任务，具有高优先级*
- *“关闭当前里程碑并列出仍在进行的工作”*
- *“哪些任务分配给我，但没有完成？”*
- *“为作战系统创建GDD文档”*
- *“设置一个webhook，以便在工作项更改时通知我的服务器”*
备注
- HacknPlan API仍处于 公开测试版 --速率限制为每秒5次通话
- API键需要用于要执行的操作的适当作用域
- 对于大多数帐户，类别、阶段和重要性级别在写入操作时返回403（列表/获取静止工作）
create_work_item 需要 boardId; importanceLevelId 默认值为3（正常）- 当使用创建工作项时
stageId，处理程序发出后续PATCH，因为API忽略 stageId POST
