AI导哈

游戏项目管理服务

HacknPlan MCP Server是一个连接Claude与HacknPlan游戏开发项目的服务，提供项目管理、任务跟踪、团队协作等功能。

  • by jompereira
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 jompereira/HacknPlan-MCP

使用说明

HacknPlan MCP服务器

将Claude直接连接到您的 HacknPlan 游戏开发项目。

设置

1.获取API密钥

  1. 登录HacknPlan
  2. 首选 个人资料→ 设置→ API测试版→ 创建
  3. 命名（例如。 claude-mcp)，选择所需的范围，单击 创建
  4. 复制密钥

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

相关 MCP