Template Ic

带Internet身份验证的MCP服务器模板

该项目演示了一个具有互联网身份验证流程的模型上下文协议（MCP）服务器。

身份验证流程

┌────────────────┐     (1) Use authenticate tool     ┌────────────────┐
│                │ ────────────────────────────────> │                │
│                │                                   │                │
│   AI Client    │                                   │   MCP Server   │
│   with MCP     │                                   │                │
│   Support      │                                   │                │
│                │  │                │
│                │                                   │                │
│   AI Client    │                                   │   MCP Server   │
│   with MCP     │                                   │  (Authenticated)│
│   Support      │                                   │                │
│                │ <─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │                │
└────────────────┘        (8) Tool responses         └────────────────┘

运作原理

1. 请求身份验证：AI客户端使用 authenticate 工具。

1. 打开身份验证URL：MCP服务器打开一个带有身份验证URL的浏览器窗口，其中包括：

- pubkey：代表团的公钥 - expiration：委派的过期时间（毫秒）

1. 用户认证React web应用程序（Auth UI）为用户提供了一个使用Internet Identity或其他支持的身份提供者进行身份验证的界面。

1. 委派创建：成功身份验证后，web应用程序使用提供的公钥和过期时间为MCP服务器创建委托链。

1. 将委派发送到服务器：web应用程序将委托链发送到配置端点处的MCP服务器。

1. 身份验证结果MCP服务器向AI客户端返回身份验证结果。

1. 访问受保护的工具：如果身份验证成功，AI客户端现在可以调用需要身份验证的其他MCP工具。

1. 受保护的响应：经过身份验证的MCP服务器用请求的数据响应工具调用。

项目结构

• mcp-server/：MCP服务器实现

- 处理MCP工具注册和请求 - 管理身份验证状态 - 处理来自web应用程序的委托

• mcp-server-wallet-connect/：用于身份验证的React web应用程序

- 连接到Internet身份 - 为MCP服务器创建委派 - 将代表团发送回服务器

安装说明

1. 为两个项目配置环境变量
2. 启动MCP服务器
3. 启动React web应用程序
4. 将您的AI客户端连接到MCP服务器

有关详细的设置说明，请参阅每个项目目录中的README文件。