解析modelcontextprotocol/servers项目中GitHub文件操作错误问题

在modelcontextprotocol/servers项目中，开发者在通过Claude Desktop工具向GitHub仓库创建或更新文件时，遇到了一个常见的错误："MCP error -32604: Invalid arguments: content.encoding: Required, content.content: Required"。这个问题主要出现在使用create_or_update_file API时，而使用push_files功能则能正常工作。

该错误的本质是API调用时缺少必要的参数。具体来说，系统要求必须提供两个关键参数：

1. content.encoding - 文件内容的编码方式
2. content.content - 文件的实际内容

经过开发者社区的深入分析，发现问题可能源于几个方面：

1. GitHub API权限设置问题，特别是使用新型精细粒度访问令牌时可能出现兼容性问题
2. MCP服务器端的参数验证逻辑过于严格
3. 客户端工具在构造请求时未能正确填充所有必填字段

解决方案方面，开发者txbm提出了有效的修复方案，通过修改服务器端的参数验证逻辑来解决此问题。值得注意的是，使用传统的GitHub访问令牌(classic token)比新型令牌更稳定可靠。

对于遇到类似问题的开发者，建议可以：

1. 检查并确保API调用时包含所有必填参数
2. 暂时使用push_files作为替代方案
3. 考虑使用经过修复的服务器版本

随着项目发展，GitHub相关的MCP服务器功能已迁移至专门的代码仓库进行维护，这反映了项目架构的优化和专业化分工趋势。此类问题的出现和解决过程，也展示了开源社区协作解决技术难题的典型模式。