本文档为在模型上下文协议(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 问题和基础设施问题
- 发布任务和里程碑跟踪
安全问题
请勿公开发布安全问题。应采取以下措施:
- 使用私密的安全报告流程。对于协议级别的安全问题,请遵循 modelcontextprotocol GitHub 仓库中 SECURITY.md 的流程。
- 直接联系负责人和/或核心维护者。
- 遵循负责任的披露准则。
决策记录
所有 MCP 决策都在公共渠道中记录和捕获。
在记录决策时,我们将尽可能保留上下文信息:
- 决策者
- 背景和动机
- 曾考虑的选项
- 选择当前方案的理由
- 实施步骤