ProjectHub MCP服务器
一个MCP（模型上下文协议）服务器，将Claude Desktop等人工智能助手连接到 ProjectHub，一个协作项目管理工具。
特性
涵盖整个ProjectHub API的25个工具：
| 类别 | 工具 |
|---|---|
| 用户 | get_user_info |
| 工作区 | list_workspaces, list_projects |
| 项目 | get_project, list_project_members, search_project, get_activity |
| 任务 | list_tasks, get_task, create_task, update_task, delete_task, toggle_task |
| 时间追踪 | start_timer, stop_timer |
| 备注 | list_notes, get_note, create_note, update_note, delete_note |
| 讨论 | list_discussions, get_discussion_messages |
| 提醒事项 | list_reminders, create_reminder, dismiss_reminder |
先决条件
- Node.js 20+
- 正在运行的ProjectHub实例
- ProjectHub个人访问令牌
创建API令牌
- 登录到ProjectHub
- 点击您的头像（右上角）→ 设置 （齿轮图标）
- 滚动到 API令牌 → click +
- 命名令牌（例如“Claude Desktop MCP”）并单击 创建
- 立即复制令牌——它只显示一次
设置
git clone
cd projecthub-mcp
npm install
npm run build配置
服务器读取两个环境变量：
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
PROJECTHUB_API_TOKEN | 是 | -- | 个人访问令牌(ph_...) |
PROJECTHUB_URL | 没有 | http://localhost:8000 | ProjectHub基本URL |
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"projecthub": {
"command": "node",
"args": ["/absolute/path/to/projecthub-mcp/dist/index.js"],
"env": {
"PROJECTHUB_URL": "http://localhost:8000",
"PROJECTHUB_API_TOKEN": "ph_your_token_here"
}
}
}
}克劳德代码
添加到您的Claude代码设置或项目配置中：
{
"mcpServers": {
"projecthub": {
"command": "node",
"args": ["/absolute/path/to/projecthub-mcp/dist/index.js"],
"env": {
"PROJECTHUB_URL": "http://localhost:8000",
"PROJECTHUB_API_TOKEN": "ph_your_token_here"
}
}
}
}发展
# Watch mode — recompiles on file changes
npm run dev
# Test interactively with the MCP Inspector
npm run inspect项目结构
src/
index.ts Entry point — creates server and connects stdio transport
api-client.ts HTTP client with auth, error handling, and response helpers
tools/
user.ts get_user_info
workspaces.ts list_workspaces, list_projects
projects.ts get_project, list_project_members, search_project, get_activity
tasks.ts list_tasks, get_task, create_task, update_task, delete_task, toggle_task
timers.ts start_timer, stop_timer
notes.ts list_notes, get_note, create_note, update_note, delete_note
discussions.ts list_discussions, get_discussion_messages
reminders.ts list_reminders, create_reminder, dismiss_reminder常见工作流
任务分类 --列出未完成的任务，审查优先级，更新或完成它们：
“显示网站重新设计项目中所有打开的高优先级任务”
站立总结 --将分配的任务与最近的活动相结合：
“给我一份项目的独立摘要”
查找上下文 --在笔记、讨论和消息中搜索：
“搜索此项目中有关身份验证错误的任何信息”
快速捕获 --从对话中创建任务、笔记或提醒：
“创建一个任务以查看下周五到期的API文档”
项目概述 --一目了然地获取项目详细信息、成员、任务和注释：
“请概述一下这个项目中发生了什么”
备注
- 认证：API令牌继承用户的完全权限-没有单独的作用域
- 讨论：通过API只读（消息通过ProjectHub UI发送）
- HTML内容：注释和消息文本以HTML格式返回
- ID：所有资源ID都是UUID，除了
user_id和assignee_id（整数）