本文档为在模型上下文协议(MCP)项目中的沟通与协作提供了实用指南。它概述了MCP社区使用的沟通渠道、工作流程和流程。 MCP社区内的所有沟通均受我们的行为准则约束。我们期望所有参与者在所有渠道中保持尊重、专业和包容的互动。

沟通渠道

我们支持三个主要沟通渠道:公共Discord服务器GitHub Issues,以及主要项目仓库中的GitHub Discussions

Discord

用于贡献者的实时讨论和协作。该服务器围绕 MCP 贡献者设计,不用于提供常规的 MCP 支持。 Discord 服务器将同时设有公共和私有频道。 点击此处加入 Discord 服务器

公共频道(默认)

  • 目的:开放的社区参与、协作开发以及透明的项目协调。
  • 主要用例
    • 公共 SDK 和工具开发:所有开发工作,从构思到发布计划,都在公共频道中进行(例如,#typescript-sdk-dev#inspector-dev)。
    • 工作组和兴趣小组讨论#client-implementors#agents-wg 等)
      • 工作组:怀有特定目标或项目(如 SDK、检查器、注册表、服务器身份、负载均衡等)。
      • 兴趣小组:一个由人们组成的抽象集会,可能会提出各种各样的话题。其中一些可能会作为一次性任务被执行,另一些可能会发展成工作组。
    • 社区入门和贡献指南。
    • 社区反馈和协作头脑风暴。
    • 公共答疑时间维护者在线时间
  • 避免
    • MCP 用户支持:期望参与者阅读官方文档,并通过 GitHub Discussions 发起新的提问或寻求支持。
    • 服务或产品营销:此 Discord 上的互动应保持供应商中立,不应用于品牌建设或销售。除非作为示例或在以规范为起点的对话中作为回应,否则不鼓励提及品牌或产品。

私有频道(例外情况)

  • 目的:用于机密协调和无法公开讨论的敏感事宜。访问权限将仅限于指定的维护者。
  • 私有使用的严格标准:
    • 安全事件(CVE、协议漏洞)。
    • 人事问题(与维护者相关的讨论、行为准则政策)。
    • 部分频道将被设置为只读。这对于例如维护者决策等情况很有用。
    • 需要立即或需要有限受众进行集中响应的协调。
  • 透明度:
    • 影响社区的所有技术和治理决策必须在 GitHub Discussions 和/或 Issues 中记录,并标记为 notes
    • 在适当时,一些与个别贡献者相关的事项可以保持私密(例如,个人情况、纪律处分或其他敏感的个人事宜)。
    • 私有频道应用作临时的“事件处理室”,而非用于日常开发。
任何在 Discord 上导致潜在决策或提案的重要讨论,都必须转移到 GitHub Discussion 或 GitHub Issue 中,以创建持久、可搜索的记录。提案随后将根据需要提升为正式的 PR,并附带相关的工作项(GitHub Issues)。

GitHub Discussions

用于就项目方向、功能、改进和社区主题进行结构化、长篇的讨论和辩论。 何时使用:
  • 项目路线图规划和里程碑讨论
  • 公告和发布沟通
  • 社区投票和共识建立过程
  • 带有背景和理由的功能请求
    • 如果某个特定仓库未启用 GitHub Discussions,可随时改为开启一个 GitHub Issue。

GitHub Issues

用于错误报告、功能跟踪和可操作的开发任务。 何时使用:
  • 提交 SEP 提案(遵循 SEP 指南
  • 包含可复现步骤的错误报告
  • 具有明确范围的文档改进
  • CI/CD 问题和基础设施问题
  • 发布任务和里程碑跟踪

安全问题

请勿公开发布安全问题。应采取以下措施:
  1. 使用私密的安全报告流程。对于协议级别的安全问题,请遵循 modelcontextprotocol GitHub 仓库中 SECURITY.md 的流程。
  2. 直接联系负责人和/或核心维护者
  3. 遵循负责任的披露准则。

决策记录

所有 MCP 决策都在公共渠道中记录和捕获。 在记录决策时,我们将尽可能保留上下文信息:
  • 决策者
  • 背景和动机
  • 曾考虑的选项
  • 选择当前方案的理由
  • 实施步骤