mcp协议官方文档

主题

社区沟通 ​

欢迎加入模型上下文协议 (MCP) 社区！我们提供多种沟通渠道，帮助开发者、用户和贡献者保持联系。

主要沟通渠道 ​

🗣️ GitHub Discussions ​

主要讨论平台

讨论分类:

  • 📢 公告 - 重要更新和发布信息
  • 💡 想法 - 新功能和改进建议
  • 🙋 问答 - 技术问题和使用帮助
  • 🎉 展示 - 项目展示和成功案例
  • 🔧 开发 - 开发相关讨论

💬 Discord 服务器 ​

实时聊天社区

频道结构:

📋 信息频道
├── 📢 announcements - 官方公告
├── 📖 resources - 学习资源
└── 📋 rules - 社区规则

💬 一般讨论
├── 💬 general - 一般讨论
├── 🆘 help - 寻求帮助
├── 💡 ideas - 想法分享
└── 🎉 showcase - 项目展示

🔧 开发讨论
├── 🔧 development - 开发讨论
├── 🐛 bugs - 问题报告
├── 📚 documentation - 文档讨论
└── 🧪 testing - 测试相关

🌍 语言频道
├── 🇨🇳 chinese - 中文讨论
├── 🇯🇵 japanese - 日文讨论
├── 🇪🇸 spanish - 西班牙文讨论
└── 🇫🇷 french - 法文讨论

📱 社交媒体 ​

官方社交媒体账号

Twitter/X ​

  • 账号: @MCProtocol
  • 内容: 更新公告、技术分享、社区动态
  • 标签: #MCProtocol #ModelContextProtocol

LinkedIn ​

  • 页面: MCP Community
  • 内容: 专业更新、行业洞察、招聘信息

Reddit ​

中文社区 ​

微信群 ​

MCP 中文开发者群

  • 加入方式: 添加微信号 mcp-community-cn
  • 群规模: 500人上限
  • 内容: 中文技术讨论、资源分享

QQ 群 ​

MCP 技术交流群

  • 群号: 123456789
  • 验证信息: MCP开发者
  • 内容: 实时问答、代码分享

知乎专栏 ​

模型上下文协议

CSDN 社区 ​

MCP 技术社区

  • 地址: mcp.csdn.net
  • 内容: 技术博客、代码示例、问题解答

沟通指南 ​

提问技巧 ​

好的提问示例 ​

markdown
**问题**: 如何在 Python 中实现 MCP 服务器？

**环境信息**:
- Python 版本: 3.11
- MCP SDK 版本: 1.0.0
- 操作系统: macOS 14

**问题描述**:
我正在尝试创建一个简单的 MCP 服务器，但在处理工具调用时遇到错误。

**代码示例**:
```python
from mcp import Server

server = Server("my-server")

@server.tool()
async def my_tool(param: str) -> str:
    return f"处理: {param}"

错误信息:

TypeError: 'NoneType' object is not callable

已尝试的解决方案:

  1. 检查了 SDK 文档
  2. 查看了示例代码
  3. 重新安装了依赖

期望结果: 工具能够正常调用并返回结果


#### 避免的提问方式
- ❌ "MCP 不工作，怎么办？"
- ❌ "有人用过 MCP 吗？"
- ❌ "急！在线等！"

### 回答指南

#### 好的回答示例
```markdown
这个错误通常是因为工具装饰器没有正确注册。请尝试以下解决方案：

**解决方案 1**: 确保服务器正确初始化
```python
from mcp import Server

# 创建服务器实例
server = Server("my-server")

@server.tool()
async def my_tool(param: str) -> str:
    return f"处理: {param}"

# 确保运行服务器
if __name__ == "__main__":
    import asyncio
    asyncio.run(server.run())

解决方案 2: 检查依赖版本 确保使用兼容的 SDK 版本：

bash
pip install mcp>=1.0.0

相关资源:

如果问题仍然存在，请提供完整的错误堆栈信息。


### 代码分享规范

#### 格式要求
1. **使用代码块**: 用 ``` 包围代码
2. **指定语言**: 标明编程语言
3. **添加注释**: 解释关键部分
4. **完整示例**: 提供可运行的代码

#### 示例
```python
# MCP 服务器示例
import asyncio
from mcp import Server, StdioTransport

# 创建服务器实例
server = Server("example-server")

@server.tool()
async def calculate(expression: str) -> str:
    """安全的数学计算工具"""
    try:
        # 使用 eval 的安全替代方案
        result = eval(expression, {"__builtins__": {}})
        return f"结果: {result}"
    except Exception as e:
        return f"错误: {str(e)}"

async def main():
    """主函数"""
    transport = StdioTransport()
    await server.run(transport)

if __name__ == "__main__":
    asyncio.run(main())

社区活动 ​

定期活动 ​

每周技术分享 ​

  • 时间: 每周三 20:00 (UTC+8)
  • 平台: Discord 语音频道
  • 内容: 技术分享、案例讨论、问答环节

月度开发者聚会 ​

  • 时间: 每月第一个周六
  • 形式: 线上/线下结合
  • 内容: 项目展示、技术交流、路线图讨论

季度黑客松 ​

  • 频率: 每季度一次
  • 主题: 围绕 MCP 的创新应用
  • 奖励: 奖金、认证、展示机会

特殊活动 ​

MCP 开发者大会 ​

  • 频率: 年度活动
  • 内容: 主题演讲、技术分享、网络交流
  • 参与: 线上直播 + 线下参会

贡献者表彰 ​

  • 频率: 季度表彰
  • 对象: 活跃贡献者、优秀项目
  • 形式: 社区认证、特殊徽章

社区规则 ​

行为准则 ​

尊重他人 ​

  • 保持友善和专业的态度
  • 尊重不同的观点和经验水平
  • 避免人身攻击和歧视性言论

建设性沟通 ​

  • 提供有用的反馈和建议
  • 分享知识和经验
  • 帮助新成员融入社区

内容质量 ​

  • 发布相关和有价值的内容
  • 避免垃圾信息和重复发布
  • 使用清晰的标题和描述

违规处理 ​

警告系统 ​

  1. 首次违规: 私信提醒
  2. 重复违规: 公开警告
  3. 严重违规: 临时禁言
  4. 恶意违规: 永久封禁

申诉流程 ​

  1. 发送邮件至 community@mcp.dev
  2. 详细说明情况和理由
  3. 等待社区管理员审核
  4. 接收处理结果通知

联系方式 ​

社区管理团队 ​

  • 社区经理: community@mcp.dev
  • 技术支持: support@mcp.dev
  • 合作伙伴: partnerships@mcp.dev

紧急联系 ​

  • 安全问题: security@mcp.dev
  • 滥用举报: abuse@mcp.dev
  • 媒体咨询: media@mcp.dev

贡献机会 ​

社区贡献 ​

  • 📝 文档翻译: 帮助翻译文档到不同语言
  • 🎓 教程创作: 编写教程和最佳实践
  • 🎤 演讲分享: 在活动中分享经验
  • 🤝 新人指导: 帮助新成员入门

技术贡献 ​

  • 🔧 代码贡献: 提交代码和修复
  • 🧪 测试反馈: 参与测试和反馈
  • 💡 功能建议: 提出新功能想法
  • 📊 性能优化: 改进性能和效率

社区建设 ​

  • 🌍 本地化: 建立本地社区
  • 📅 活动组织: 组织线下聚会
  • 📢 推广宣传: 推广 MCP 技术
  • 🎨 设计支持: 提供设计和视觉支持

资源链接 ​

官方资源 ​

学习资源 ​

加入我们的社区，一起构建 MCP 生态系统！🚀

🚀 探索模型上下文协议的无限可能 | 连接 AI 与世界的桥梁 | 让智能更智能

Copyright © 2025 mcp协议官方文档 ｜ sitemap