MCP服务器参考实现

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用于生产

入门指南

1. 选择您的实施方式：

   • 对于学习或简单工具：从 basic/
   • 对于建筑生产应用：使用 with-authorization/

2. 按照设置指南进行操作：

   • 每个目录都包含详细的设置说明
   • 包括环境配置示例
   • 提供开发和部署指南

3. 轻松部署：

   • 包括一键式Vercel部署按钮
   • 云部署的环境变量指南
   • 起动机配置

架构优势

• 可维护性：干净的TypeScript代码和全面的文档
• 可扩展：开源基础允许自定义修改
• 遵从标准：完全符合MCP规范，包括授权

贡献

此参考实现可作为社区构建的基础。欢迎提供改进安全性、性能、文档或添加新功能的贡献。

资源

• 模型上下文协议规范
• MCP授权规范
• Next.js文档
• SpiceDB文档
• 更好的身份验证文档

许可证

看 许可证 了解详情。