核心功能
Basecamp CLI 是专为 Basecamp 4 打造的官方级命令行工具与 MCP 服务器,深度集成 Basecamp 完整 API 生态。提供 76 个 MCP 工具覆盖项目管理全场景,包括:
- 项目与协作:项目创建/归档、成员管理、消息发布、 campfire 实时沟通
- 任务管理:待办清单、任务分组、任务状态流转、跨列表移动
- 知识库与文档:Vault 存储、文档编辑、文件上传管理
- 看板工作流:Card Table 列管理、卡片创建与移动
- 日程与事件:日程条目 CRUD、全局事件订阅
- 自动化支持:Webhook 配置、全局搜索、归档恢复机制
技术亮点
- 智能重试机制:自动分页 + 指数退避重试,保障 API 调用稳定性
- OAuth 2.0 + PKCE:企业级安全认证流程
- 双模式输出:CLI 交互友好,同时支持
--format json结构化数据 - AI 原生设计:MCP 协议深度适配,支持 Claude 等 AI 助手直接调用
潜在局限
1. 生态绑定:仅支持 Basecamp 4,无法迁移至其他项目管理平台
2. 认证门槛:需手动创建 37signals OAuth 应用,配置流程对非技术用户不够友好
3. Node 版本限制:要求 Node.js ≥ 20,老旧环境需升级
4. 功能边界:依赖 Basecamp API 能力上限,部分高级报表功能需 Web 端补充
适用人群
- 技术团队:开发者、DevOps 工程师、技术项目经理
- 自动化需求者:需将 Basecamp 数据接入 CI/CD 或内部工具链
- AI 增强办公:希望通过 Claude 等 AI 助手直接管理 Basecamp 工作流
风险提示
- Token 安全:
BASECAMP_CLIENT_SECRET需妥善保管,避免硬编码至版本控制 - OAuth 回调固定:开发环境需占用
localhost:9292端口 - Rate Limit:高频调用可能触发 Basecamp API 限流,建议结合指数退避使用