glam mcp
  ](https://www.npmjs.com/package/glam-mcp)
一个纯MCP(模型上下文协议)服务器,通过为AI助手提供丰富的上下文响应来提供智能开发体验。glam-mcp将人工智能辅助开发转变为“与高级开发人员配对编程”的体验。
概述
glam-mcp是一个模型上下文协议服务器,旨在通过深度开发上下文、团队意识和智能工作流编排来增强人工智能助手的能力。通过为每次操作提供丰富的元数据、上下文建议和安全分析,glam-mcp使AI助手能够提供更智能、更有用的开发体验。
主要特点
🎯 纯MCP架构
- 清洁MCP服务器实施,无需CLI依赖
- 丰富的上下文响应,指导人工智能助手
- 智能建议的状态会话跟踪
🧠 增强型响应系统
每个工具响应包括:
- 核心成果:操作成功/失败和数据
- 上下文对象:建议、风险、相关工具、团队活动、最佳实践
- 元数据:操作类型、时间戳、受影响的文件、会话上下文
👥 团队意识
- 检测团队成员何时处理相关代码
- 根据文件所有权建议合适的审阅者
- 在潜在冲突发生之前发出警告
- 跟踪分支和文件上最近的团队活动
🛡️ 内置安全
- 每项操作的风险评估
- 冲突检测和预防
- 先决条件验证
- 错误恢复建议
🔧 综合工具集
- GitHub流工具:分支机构创建、公关管理、问题跟踪
- 自动化工具:智能提交、PR创建、发布工作流程
- 上下文工具:会话跟踪、偏好管理、操作历史
- 团队工具:活动监控、审阅者建议、冲突检测
- 安全工具:风险分析、冲突检查、前提条件验证
安装
npm install glam-mcp配置
添加到您的Claude Desktop配置(~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"glam": {
"command": "node",
"args": ["/path/to/glam-mcp/src/index.js"]
}
}
}对于其他MCP客户端,请参阅其特定的配置文档。
用法
配置后,您的AI助手可以使用glam-mcp工具。AI将根据您的自然语言请求智能地编排这些工具。
示例工作流
启动新功能:
"I need to create a new feature for user authentication"AI助手将使用glam-mcp来:
- 检查现有相关工作
- 创建适当的分支
- 设置初始结构
- 建议下一步行动
创建pull请求:
"Let's create a PR for this feature"Glam提供:
- 自动提交分组
- PR描述生成
- 基于触摸文件的审阅者建议
- 冲突警告
开始工作前检查团队活动:
"Who's working on the API endpoints right now?"Glam mcp通过以下方式提供帮助:
- 扫描最近的提交和活动分支
- 识别处理相关文件的团队成员
- 建议协调策略
- 关于潜在冲突的警告
智能提交工作流:
"Commit these changes with a good message"助理将:
- 分析更改以确定提交类型
- 生成常规提交消息
- 适当的集团相关变更
- 如果需要,建议拆分大型提交
发布准备:
"Is this branch ready to merge to main?"Glam mcp执行:
- 与主分支冲突检测
- CI/CD状态验证
- 测试覆盖率分析
- 合并风险评估
调试失败的PR:
"Why are the PR checks failing?"助理利用glam-mcp来:
- 获取详细的CI/CD日志
- 确定根本原因
- 根据错误模式建议修复
- 检查类似问题是否影响其他PR
代码审查协助:
"Help me review this PR"Glam提供:
- 自动生成检查表
- 高风险变更识别
- 测试覆盖率验证
- 对其他审阅者的建议
与上游更改同步:
"Update my branch with the latest from main"助理将:
- 同步前检查冲突
- 安全地保存本地更改
- 自动解决简单冲突
- 指导解决复杂的冲突
寻找相关工作:
"Is anyone else working on the user service?"Glam mcp搜索:
- 活动分支接触类似文件
- 同一地区最近的PR
- 具有该代码专业知识的团队成员
- 相关文件或问题
设置开发环境:
"Set up my workspace for this project"助理使用glam-mcp来:
- 使用正确的配置克隆存储库
- 设置git挂钩和别名
- 配置团队首选项
- 初始化会话上下文
高级工作流
多分支发展:
"I need to work on both the frontend and backend changes simultaneously"Glam mcp策划:
- 为前端和后端创建单独的分支
- 跟踪更改之间的依赖关系
- 建议集成点
- 管理跨分支冲突
- 协调PR测序
修补程序部署:
"We need to deploy a critical fix to production immediately"助理协调:
- 从生产标签创建修补程序分支
- 安全绕过正常审查流程
- 确保修复是精心挑选的
- 更新所有活动功能分支
- 记录紧急变更
大型重构项目:
"Help me refactor the entire authentication module"Glam mcp提供:
- 将重构分解为安全阶段
- 创建增量提交
- 保持向后兼容性
- 与受影响的团队协调
- 通过检查表跟踪进度
依赖关系更新工作流:
"Update all our dependencies safely"助理将:
- 检查更新中的重大更改
- 创建独立的测试分支
- 运行全面的测试套件
- 生成详细的更新报告
- 建议分阶段推出策略
跨团队协作:
"Coordinate with the mobile team on the new API"Glam mcp有助于:
- 创建共享分支
- 设置集成测试
- 跟踪API合同变更
- 协调发布时间
- 管理文档更新
工具类别
GitHub流工具
github_flow_start:从创建分支开始功能开发github_flow_pr:创建具有智能默认值的PRgithub_check_pr_status:监督PR检查和审查
自动化工具
auto_commit:使用传统消息进行智能提交auto_pr:根据上下文自动创建PRpr_review_checklist:生成审查清单
上下文工具
get_session_context:检索当前会话状态set_user_preference:存储用户首选项get_recent_operations:查看操作历史记录
团队工具
check_team_activity:监控相关代码的团队工作find_related_work:发现相关分支机构/PRsuggest_reviewers:获取审阅者建议
安全工具
analyze_operation_risk:评估运营风险check_for_conflicts:检测潜在冲突validate_preconditions:确保安全操作
建筑
src/
├── index.js # MCP server entry point
├── tools/ # Tool implementations
│ ├── github-flow.js # GitHub workflow tools
│ ├── automation.js # Automation tools
│ ├── context.js # Context management tools
│ ├── team.js # Team collaboration tools
│ └── safety.js # Safety and validation tools
├── enhancers/ # Response enrichment
│ ├── metadata.js # Operation metadata
│ ├── suggestions.js # Next step suggestions
│ ├── risk.js # Risk assessment
│ └── team.js # Team activity
├── context/ # Session management
│ └── session.js # Session state tracking
└── utils/ # Utilities
├── git-helpers.js # Git operations
└── responses.js # Response formatting响应结构
每个工具都会返回丰富的响应:
{
success: true,
data: { /* operation-specific data */ },
context: {
suggestions: ["next steps..."],
risks: ["potential issues..."],
relatedTools: ["tool_name"],
teamActivity: { /* current team work */ },
bestPractices: ["recommendations..."]
},
metadata: {
operation: "tool_name",
timestamp: "2024-01-09T10:00:00Z",
affectedFiles: ["file1.js", "file2.js"],
sessionContext: { /* session state */ }
}
}发展
# Install dependencies
npm install
# Run tests
npm test
# Start in development mode
npm run devCI/CD管道
该项目使用GitHub Actions进行持续集成和部署。该管道通过自动化测试和检查确保代码质量和稳定性。
拉取请求检查
每个pull请求都会触发以下检查:
- 多个Node.js版本:测试在Node.js 18.x和20.x上运行
- 测试套件:具有覆盖率报告的完整测试套件
- 代码Linting:ESLint检查代码质量
- 格式检查:对一致格式进行预处理验证
- 安全审计:npm审计依赖漏洞
- 构建验证:确保项目成功构建
- 自动标签:PR会根据更改的文件自动标记
分支保护
这 main 分支受到以下要求的保护:
- 所有CI检查必须通过
- 合并前,分支机构必须保持最新状态
- 合并前需要对话解析
在本地运行CI
在推送之前,您可以在本地运行相同的检查:
# Run all tests with coverage
npm test -- --coverage
# Check linting
npm run lint
# Check formatting
npm run format:check
# Run security audit
npm audit发布过程
该项目通过GitHub Actions使用自动发布。要创建新版本,请执行以下操作:
- 更新版本:更新中的版本
package.json根据 语义版本控制 - 更新变更日志:将您的更改添加到
CHANGELOG.md在“未发布”部分 - 提交更改:使用以下消息提交
chore: prepare release v1.2.3 - 创建标签:
git tag v1.2.3 && git push origin v1.2.3
自动化工作流程将:
- 验证版本格式
- 在Node.js 18.x和20.x上运行测试
- 从提交历史记录生成发布说明
- 发布到npm注册表
- 使用工件创建GitHub版本
- 为下一个版本更新打开PR
手动释放
您还可以手动触发释放:
- 转到操作→ 发布→ 运行工作流
- 输入版本号(例如。,
1.2.3) - 检查“预发布”(如适用)
发布版本
对于预发布版本,请使用以下版本号 1.2.3-beta.1 或 1.2.3-rc.1.这些将发布到npm beta 标签。
贡献
欢迎投稿!在提交PR之前,请确保所有CI检查都通过。自动检查将对需要解决的任何问题提供反馈。
许可证
MIT许可证-有关详细信息,请参阅许可证文件
支持
- 问题:
- 文档: 全部文件
______________________________________________________________________
内置于❤️ 使人工智能辅助开发更加智能和协作。
