2025年12月2日，github-mcp-server 发布了 v0.24.0 版本，这是一次重要的更新版本，其中包含了核心框架的迁移以及多项新功能和改进。

一、重要更新概览

1. 核心SDK迁移

• 本次版本将 GitHub MCP Server 的核心 Model Context Protocol 实现从 mark3labs/mcp-go 迁移到了 modelcontextprotocol/go-sdk。
• 此更改对最终用户应当是透明的，但由于涉及底层协议库替换，建议在使用过程中关注可能出现的回归问题并及时反馈。

2. 新增功能

• 仓库资源补全（Repository Resource Completion）
  新增了资源补全能力，支持针对 GitHub 仓库资源进行补全处理，使 AI 工具能更智能地获取相关仓库信息与资源列表。
• AI 问题评估工作流（AI Issue Assessment Workflow）
  新增 GitHub Actions 工作流文件 .github/workflows/ai-issue-assessment.yml，可在 Issue 创建或添加标签时自动调用 AI 进行评估，并根据评估结果添加标签或评论。
  • 支持 bug 报告评估 和 默认新问题评估 两种 prompt 文件：
    • .github/prompts/bug-report-review.prompt.yml
    • .github/prompts/default-issue-review.prompt.yml
  • AI 会根据问题或Bug报告的完整性自动给出三种评估结果：
    • Ready for Review
    • Missing Details
    • Unsure

3. 其他改进

• 增加了 X-MCP-Tools 的文档说明（docs/remote-server.md），详细描述了 Remote Server 对应的请求头与本地服务器参数的映射关系。
• 修正了只读模式下工具跳过逻辑：确保在判断只读模式时不会错误跳过可写工具的检查条件。
• README 中调整了部分工具参数说明格式，使描述更清晰一致。

二、文档更新

1. docs/remote-server.md

新增了 Remote Server 支持的可选请求头说明，包括：

• X-MCP-Toolsets：启用的工具集列表
• X-MCP-Tools：启用的单个工具列表
• X-MCP-Readonly：只读模式开关
• X-MCP-Lockdown：锁定模式开关

同时详细说明了这些请求头在本地服务器中的等效配置方式（通过环境变量或命令行参数）。

2. docs/server-configuration.md（新增350行）

新增《服务器配置指南》，包括：

• 快速参考：Remote Server 与 Local Server 的各个配置项映射表
• 配置原理说明：支持组合多种配置选项（工具集、单工具、动态发现、只读、锁定模式）
• 多种配置场景示例：
  • 启用特定工具
  • 启用特定工具集
  • 组合工具集与单工具
  • 只读模式
  • 动态发现模式（仅本地服务器）
  • 锁定模式
• 故障排查：无效工具名、只读模式限制、工具集缺失等问题的解决方法
• 相关文档链接：README 工具配置、工具集列表、工具列表、Remote Server文档、安装指南

三、核心代码变动

• 协议库替换
  文件 cmd/github-mcp-server/generate_docs.go 中，将原有的 github.com/mark3labs/mcp-go/mcp 替换为了 github.com/modelcontextprotocol/go-sdk/mcp，并适配了新的 jsonschema 类型检查方式以生成工具参数文档。
• 工具参数生成逻辑优化
  在生成工具文档时，新增了对空 InputSchema 的处理，当工具无需参数时明确显示“无参数”。同时改为使用 jsonschema.Schema 类型以获取参数类型与描述信息。

四、贡献者与代码统计

• 本次更新涉及 6 个提交
• 修改了 165 个文件
• 总计 12,259 行新增 和 8,517 行删除
• 共有 13 位贡献者参与

五、总结

代码地址：github.com/github/github-mcp-server

github-mcp-server v0.24.0 是一次较为重要的版本升级，主要亮点包括：

• 底层 SDK 迁移至新协议库 modelcontextprotocol/go-sdk
• 引入仓库资源补全能力
• 增加 AI 自动问题评估工作流
• 丰富文档配置示例与 Remote Server 说明