AI导哈

项目管理协议服务器

Teamhood MCP Server是一个模型上下文协议服务器，用于Teamhood项目管理，使AI助手如Claude能够与Teamhood工作区、看板、任务等进行交互。

  • by vanmarkic
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 vanmarkic/teamhood-mcp

使用说明

Teamhood MCP服务器

一种模型上下文协议（MCP）服务器 团队精神 项目管理。使像Claude这样的人工智能助手能够与Teamhood工作区、董事会、项目等进行交互。

特性

工作区

  • list_workspaces -列出所有可访问的工作区
  • get_workspace -获取工作区详细信息
  • create_workspace -创建新工作区（需要模板）
  • update_workspace_member -添加/更新用户角色

板子

  • list_boards -列出工作区中的板
  • get_board -获取特定的电路板详细信息
  • create_board -创建新板（需要模板）
  • list_rows -在黑板上列出泳道
  • list_statuses -列出板上的状态列
  • create_row -创建新泳道

项目（任务/卡片）

  • list_items -使用分页搜索/筛选项目
  • get_item -获取完整的商品详细信息
  • create_item -使用依赖项、标签和自定义字段创建新项目
  • update_item -更新项目属性
  • delete_item -永久删除项目
  • move_item -在板/列/行之间移动项目
  • archive_item -存档/取消存档项目（软删除）

附件

  • list_attachments -列出项目的附件
  • get_attachment -获取附件元数据
  • download_attachment -下载附件内容
  • upload_attachment -将文件上传到项目
  • update_attachment -重命名附件
  • delete_attachment -删除附件

时间跟踪

  • log_time -记录在项目上花费的时间
  • get_time_logs -使用过滤器查询时间日志

模板

  • list_workspace_templates -可用的工作空间模板
  • list_board_templates -可用的电路板模板

活动和日志

  • list_activities -项目变更历史记录（审核日志）
  • list_system_logs -按日期范围列出的系统日志

用户

  • list_users -列出所有组织用户

安装

npm install
npm run build

配置

选项1：环境变量

export TEAMHOOD_API_KEY="your-api-key"
export TEAMHOOD_BASE_URL="https://api-YOURTENANT.teamhood.com/api/v1"

选项2:SOPS加密秘密

创建 secrets.yaml:

TEAMHOOD_API_KEY: your-api-key
TEAMHOOD_BASE_URL: https://api-YOURTENANT.teamhood.com/api/v1

使用SOPS加密：

sops -e secrets.yaml > secrets.enc.yaml

Claude桌面设置

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "teamhood": {
      "command": "node",
      "args": ["/path/to/teamhood-mcp/dist/index.js"],
      "env": {
        "TEAMHOOD_API_KEY": "your-api-key",
        "TEAMHOOD_BASE_URL": "https://api-YOURTENANT.teamhood.com/api/v1"
      }
    }
  }
}

API费率限制

Teamhood API限制为每分钟100个请求。

许可证

麻省理工学院

相关 MCP