MCP服务器参考实现
该存储库为基于开源技术构建的托管MCP(模型上下文协议)服务器提供了参考实现。这些实现是持续开发的基础,并展示了构建生产就绪MCP服务器的不同架构模式。
什么是MCP?
模型上下文协议(MCP)是一个开放标准,它使用户和AI代理能够安全地连接到数据源和工具。MCP服务器公开了AI模型可以用来增强其功能的资源、工具和提示。
存储库概述
此存储库包含两个完整的参考实现,专为 远程托管MCP服务器 可以部署到云端并通过HTTP访问:
📁 基本/
演示核心概念和基本功能的最小MCP服务器实现。
特征:
- 带有App Router的简单Next.js 15应用程序
- MCP服务器端点使用
mcp-handler图书馆 - 示例工具实现
- 准备立即部署
- 最小的依赖关系和配置
非常适合:
- 学习MCP基础知识
- 快速原型设计
- 简单的工具实现
- 教育目的
📁 经授权/
具有完整身份验证和授权功能的全面MCP服务器实现。
特征:
- 用户注册/登录的完整身份验证系统
- 使用SpiceDB进行细粒度授权
- MCP授权规范的OAuth 2.0合规性
- 具有更好身份验证的会话管理
- 权限模型示例
- 管理用户权限的示例
非常适合:
- 生产托管MCP服务器的基础
开源基金会
该项目完全基于开源解决方案构建,以确保透明度、安全性和可扩展性:
核心技术
- Next.js 15 -带有App Router的现代React框架
- TypeScript -类型安全和开发人员经验
- Node.js -运行时环境
MCP实施
- @模型上下文协议/sdk -MCP官方TypeScript SDK
- mcp处理器 -简化的MCP服务器创建库
- 萨德 -工具参数的运行时类型验证
身份验证和授权(仅限授权)
- 更好的身份验证 -带有PostgreSQL后端的现代身份验证库
- SpiceDB -谷歌桑给巴尔灵感授权系统
- PostgreSQL -可靠的用户数据数据库
UI和样式(仅限授权)
- 尾风CSS -实用程序优先的CSS框架
- shadcn/ui -高质量的可访问UI组件
- Radix UI -可访问性的原始组件
- Lucide反应 -美丽的图标库
外部服务
需要授权
- PostgreSQL -用户身份验证数据数据库
- SpiceDB -权限管理授权服务
- 可以在本地运行以进行开发 - 建议将AuthZed Cloud用于生产
入门指南
- 选择您的实施方式:
- 对于学习或简单工具:从 basic/ - 对于建筑生产应用:使用 with-authorization/
- 按照设置指南进行操作:
- 每个目录都包含详细的设置说明 - 包括环境配置示例 - 提供开发和部署指南
- 轻松部署:
- 包括一键式Vercel部署按钮 - 云部署的环境变量指南 - 起动机配置
架构优势
- 可维护性:干净的TypeScript代码和全面的文档
- 可扩展:开源基础允许自定义修改
- 遵从标准:完全符合MCP规范,包括授权
贡献
此参考实现可作为社区构建的基础。欢迎提供改进安全性、性能、文档或添加新功能的贡献。
资源
许可证
看 许可证 了解详情。
