贡献者沟通

贡献者沟通

社区译文;来源: MCP 80041ab0

本文说明如何在 Model Context Protocol(MCP)项目中沟通与协作。

沟通渠道

渠道用途适用场景
Discord实时讨论快速提问、协调、WG/IG 讨论
线上会议同步交流WG/IG 演示、进展汇报
GitHub Discussions结构化讨论提案、路线图规划、较长篇幅的辩论
GitHub Issues可执行任务错误报告、文档修复
漏洞报告安全问题漏洞,绝不能公开发布

所有沟通均受我们的行为准则约束。我们期望所有渠道中的互动都尊重他人、专业且包容。

Discord

MCP Contributor Discord 用于贡献者之间的实时讨论和协作。该服务器面向 MCP 贡献者,不用于一般 MCP 支持。

公开频道(默认)

**目的:**开放的社区参与、协作开发和透明的项目协调。

主要使用场景:

  • SDK 和工具开发(例如 #typescript-sdk-dev、#inspector-dev)
  • 工作组和兴趣组讨论(例如 #auth-wg、#security-ig)
  • 社区新成员引导和贡献指导
  • 社区反馈和协作式头脑风暴
  • 公开答疑时间和维护者在线时段

避免:

  • MCP 用户支持:请阅读官方文档,并使用 GitHub Discussions 提问
  • 服务或产品营销:讨论应保持供应商中立;除非是与规范有关的示例,否则不鼓励提及品牌

私有频道(例外)

**目的:**机密协调和敏感事项。访问权限仅限指定维护者。

允许私下处理的条件:

  • 安全事件(CVE、协议漏洞)
  • 人员事项(维护者讨论、行为准则问题)
  • 需要有限参与者立即或集中响应的协调
  • 某些频道仅供维护者只读查看决策过程

透明度要求:

  • 影响社区的所有技术和治理决策都必须记录在 GitHub Discussions 和/或 Issues 中,并标记 notes 标签
  • 私有频道是临时“事件响应室”,不用于日常开发
  • 与个人贡献者有关的某些事项可在适当情况下保持私密

Discord 上产生潜在决定或提案的任何重要讨论,都必须转移到 GitHub Discussion 或 Issue,以形成持久且可搜索的记录。

GitHub Discussions

用于围绕项目方向开展结构化、长篇幅的讨论和辩论。

适用场景:

  • 项目路线图规划和里程碑讨论
  • 公告和发布沟通
  • 社区投票和共识形成
  • 包含背景与理由的功能请求
  • 如果仓库未启用 Discussions,则改用 GitHub Issues

GitHub Issues

用于错误报告和可执行的开发任务。功能请求应提交到 GitHub Discussions。

适用场景:

  • 含可复现步骤的错误报告
  • 范围明确的文档改进
  • CI/CD 问题和基础设施问题
  • 发布任务和里程碑跟踪

**注意:**SEP 提案以 pull request 形式提交到 seps/ 目录,而不是作为 GitHub Issue 提交。参见 SEP 指南。

安全问题

请勿公开发布安全问题。

  1. 使用 SECURITY.md 中的私密安全报告流程
  2. 直接联系 Lead Maintainer 或核心维护者
  3. 遵循负责任披露指南

决策记录

所有 MCP 决策都记录在公开渠道中:

类型位置
技术决策GitHub Issues 和 SEP
规范变更变更日志
流程变更社区文档
治理决策GitHub Issues 和 SEP

记录决策时,我们尽可能保留以下背景:

  • 决策者
  • 背景与动机
  • 考虑过的选项
  • 选择该方案的理由
  • 实施步骤