项目介绍
MCP 完全指南:模型上下文协议服务器的综合入门套件
最详尽的模型上下文协议(MCP)及其服务器的仓库规范。通过本完全指南学习如何构建、保护和部署MCP服务器。
此仓库包含了MCP服务器开发所需的一切:
- 正式规范:MCP协议的JSON Schema、Protobuf和OpenAPI规范
- 参考实现:使用Python(aiohttp)、Node.js(Express + WebSocket)和Go(gRPC + HTTP)多语言编写的服务器
- SDK和工具:Python、Node.js和Go的客户端SDK,以及用于测试的CLI工具
mcpctl
- CI/CD流水线:自动化构建、安全扫描、SBOM生成和容器化
- 部署就绪:Kubernetes Helm图表、Dockerfile和示例清单
- 可观测性套件:OpenTelemetry跟踪、Prometheus指标、Grafana仪表盘
- 最佳安全实践:OPA Rego策略、mTLS示例、OAuth2设置、威胁模型
- 全面测试:单元测试、契约测试、模糊测试、使用k6和locust进行负载测试
- 运营手册:事件响应、密钥轮换、数据外泄处理
快速开始
- 克隆仓库:
git clone https://github.com/kawacukennedy/mcp-complete-guide.git
- 运行一个服务器:
cd examples/python_server && python server/server.py
- 在
docs/中浏览文档或使用CLI:./tools/mcpctl/mcpctl.py manifest http://localhost:8080
查看SUMMARY.md以获取完整的目录,并深入到docs/中的详细章节了解关于MCP协议、安全性、可观测性等内容。