mcp-server-template-ic

🚀 MCP 服务器模板与互联网身份认证

本项目展示了一个带有互联网身份认证流程的 Model Context Protocol (MCP) 服务器，为 AI 客户端与 MCP 服务器之间的交互提供了安全可靠的身份认证机制。

🚀 快速开始

本项目主要呈现了带有互联网身份认证流程的 MCP 服务器，下面为你详细介绍其身份验证流程及工作原理。

✨ 主要特性

• 提供完整的互联网身份认证流程，保障 AI 客户端与 MCP 服务器交互的安全性。
• 通过委派链机制，实现用户身份的有效验证。

📚 详细文档

身份验证流程

┌────────────────┐     (1) 使用认证工具进行认证     ┌────────────────┐
│                │ ────────────────────────────────> │                │
│                │                                   │                │
│   AI 客户端    │                                   │   MCP 服务器   │
│   带有 MCP 支持 │                                   │                │
│                │ <─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │                │
└────────────────┘     (6) 认证结果              └────────────────┘
        │                                                     │
        │                                                     │ (2) 打开认证 URL
        │                                                     以 pubkey 和过期时间
        │                                                     ▼
        │                                           ┌────────────────┐
        │                                           │                │
        │                                           │  React 网页应用 │
        │                                           │  (认证 UI)      │
        │                                           │                │
        │                                           └────────────────┘
        │                                                     │
        │                                                     │ (3) 用户进行身份验证
        │                                                     使用互联网身份
        │                                                     ▼
        │                                           ┌────────────────┐
        │                                           │                │
        │                                           │ 互联网身份      │
        │                                           │                │
        │                                           └────────────────┘
        │                                                     │
        │                                                     │ (4) 返回委派
        │                                                     ▼
        │                                           ┌────────────────┐
        │                                           │                │
        │                                           │ React 网页应用 │
        │                                           │ (认证 UI)      │
        │                                           │                │
        │                                           └────────────────┘
        │                                                     │
        │                                                     │ (5) 发送委派
        │                                                     至 MCP 服务器
        ▼                                                     ▼
┌────────────────┐     (7) 调用其他 MCP 工具     ┌────────────────┐
│                │ ────────────────────────────────> │                │
│                │                                   │                │
│   AI 客户端    │                                   │   MCP 服务器   │
│   带有 MCP 支持 │                                   │ 已认证         │
│                │ <─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │                │
└────────────────┘        (8) 工具响应           └────────────────┘

工作原理

1. 请求认证：AI 客户端调用 MCP 服务器的 authenticate 工具。
2. 打开认证 URL：MCP 服务器打开浏览器窗口，显示包含以下内容的认证 URL：
   • pubkey：用于委派的公钥
   • expiration：委派的有效期（以毫秒为单位）
3. 用户身份验证：React 网页应用（认证 UI）提供界面，供用户使用互联网身份或其他支持的身份提供商进行身份验证。
4. 委派链创建：在成功身份验证后，网页应用使用提供的公钥和过期时间生成 MArké 服务器的委派链。
5. 发送委派到服务器：网页应用将委派链发送回 MCP 服务器指定的端点。
6. 认证结果：MCP 服务器向 AI 客户端返回认证结果。
7. 调用其他工具：AI 客户端可以调用 MCP 服务器上的其他工具，而 MCP 服务器已验证身份。
8. 工具响应：MCP 服务器根据请求返回相应的响应。

项目结构

- mcp-server/：MCP 服务器实现
- mcp-server-wallet-connect/：React 网页应用，用于身份验证