🚀 MCP 试验 01 - 认证用户管理系统

![TypeScript](https://www.typescriptlang.org/) ](https://nodejs.org/) ![MCP](https://modelcontextprotocol.io/) ![PostgreSQL](https://www.postgresql.org/) ![Prisma](https://www.prisma.io/) ![Stytch](https://stytch.com/) ![Google AI](https://ai.google.dev/)

A. 生产就绪的模型上下文协议（MCP） 实现企业级认证、PostgreSQL数据库以及AI集成。功能包括Stytch魔法链接认证、Prisma对象关系映射（ORM）、基于角色的权限管理、审计日志以及全面的用户管理工具。

📋 目录

特点/功能
快速入门
建筑学
先决条件
安装
数据库设置
身份验证设置
配置
使用方法/用途
文档编写指南
MCP服务器组件
客户端功能
数据库管理
脚本与工具
VS Code 集成
API 参考文档
故障排除
做出贡献
许可证

✨ 特点

🔐（锁形符号，常用于表示密码或保密）企业认证

Stytch 集成无密码的魔法链接认证
PostgreSQL 数据库使用 Prisma ORM 保护用户数据
权限系统基于角色的访问控制（RBAC）
审计日志记录全面的活动追踪与合规管理
令牌验证使用JWT实现安全的会话管理
OAuth回调服务器用于认证流程的Express.js服务器

🗄️ 该符号在中文中通常没有直接对应的翻译，它是一个文件夹或文件柜的图标，常用于表示文件、资料或存储空间。在没有具体上下文的情况下，可以简单地将其描述为“文件夹图标”或“文件柜图标”。如果需要在句子中使用，可以根据上下文灵活翻译，例如：“请将文件放在文件夹图标里。” 数据库 & 对象关系映射（ORM）

PostgreSQL（译为“波斯特格瑞斯数据库”或直接保留原英文名，根据语境选择）生产就绪的关系数据库
Prisma ORM（对象关系映射框架）带自动补全功能的类型安全数据库查询
迁移系统版本控制的模式更改
Prisma Studio（普里斯玛工作室）可视化数据库浏览器和编辑器
数据验证使用Zod模式进行运行时验证
连接池优化数据库性能

🏗️ 代表“建筑工地”或“正在建造中”。 MCP服务器功能

🔧 工具创建并管理经过验证的用户
📚 资源访问用户数据（所有用户或特定配置文件）
💬 提示/指令利用人工智能生成虚假用户
🛡️ 受保护的终端节点基于权限的访问控制
💾 双存储PostgreSQL（生产环境）和JSON（开发环境）两者都使用

🎭 表情符号“🎭”的中文翻译可以是“戏剧面具”或“表演面具”，它通常用来表示戏剧、表演或娱乐相关的主题。交互式客户端

经过身份验证的客户端与Magic Link的全面Stytch集成
交互式命令行界面 (CLI)用户友好的菜单驱动界面
基本客户端用于测试的简单MCP客户端
🤖 人工智能集成带有函数调用的Google Gemini
✅ 输入验证带重试逻辑的全面验证
🔄 实时通信无缝支持MCP协议

🚀 快速入门

5分钟内快速启动并运行：

# 1. Clone and install
git clone https://github.com/mariemMoula/mcp-trial-01.git
cd mcp-trial-01
npm install

# 2. Setup environment (copy .env.example to .env and add your keys)
# Required: DATABASE_URL, STYTCH_PROJECT_ID, STYTCH_SECRET, GEMINI_API_KEY

# 3. Setup database
npm run db:migrate    # Create database schema
npm run db:import     # Import sample users (optional)

# 4. Run the authenticated server
npm run client:interactive

# 5. Login with your email and click the magic link!

就是这样！ 现在，您已拥有了一个完全认证的MCP服务器，并配备了PostgreSQL。 🎉

🏛️ 建筑学

🎯 AUTHENTICATED MCP SYSTEM

┌─────────────────────────────────────┐
│       👤 USER (your@email.com)      │
└──────────────┬──────────────────────┘
               │
               ↓ 1. Request Magic Link
    ┌──────────────────────┐
    │   � STYTCH AUTH     │
    │   Send Magic Link    │
    │   Verify Email       │
    │   Issue Token        │
    └──────────┬───────────┘
               │
               ↓ 2. Access Token
    ┌──────────────────────┐
    │  🎭 AUTH CLIENT      │
    │  Token Management    │
    │  OAuth Server        │
    │  Interactive Menu    │
    └──────────┬───────────┘
               │
               ↓ 3. Authenticated Requests
    ┌──────────────────────┐
    │  🏗️ AUTH SERVER      │
    │  ├─ Validate Token   │
    │  ├─ Check Permissions│
    │  ├─ Execute Tools    │
    │  ├─ Access Resources │
    │  └─ Log Audits       │
    └──────────┬───────────┘
               │
               ↓ 4. Database Queries
    ┌──────────────────────┐
    │  �️ POSTGRESQL       │
    │  ├─ users (auth)     │
    │  ├─ sessions         │
    │  ├─ permissions      │
    │  ├─ audit_logs       │
    │  └─ mcp_users (data) │
    └──────────────────────┘

两种用户模型

模型	表	目的	管理者
`User`	`users`	身份验证与权限	Stytch
`McpUser`	`mcp_users`	MCP 工具数据	MCP 工具

为什么要分开？ 不同的生命周期、安全隔离机制以及访问模式。

📋 先决条件

Node.js 18+
PostgreSQL（译为“波斯特格瑞斯”或直接使用原英文名，因其为数据库管理系统名称，通常不翻译） 12+（本地或托管）
npm 或者 纱线；线团
Stytch 账户 （提供免费套餐）
谷歌人工智能API密钥 (双子座)
VS Code（Visual Studio Code，简称VS Code） （可选，用于MCP集成）

🚀 安装

# 1. Clone the repository
git clone https://github.com/mariemMoula/mcp-trial-01.git
cd mcp-trial-01

# 2. Install dependencies
npm install

# 3. Build TypeScript files
npm run build

🗄️ 数据库设置

选项1：本地PostgreSQL（推荐用于开发）

# Install PostgreSQL on Windows
# Download from: https://www.postgresql.org/download/windows/

# After installation, create database
psql -U postgres
CREATE DATABASE mcp_trial;
\q

# Your DATABASE_URL will be:
# postgresql://postgres:your_password@localhost:5432/mcp_trial

选项2：托管PostgreSQL（推荐用于生产环境）

使用任何PostgreSQL托管服务：

Supabase（注：这是一个专有名词，通常不直接翻译，但为符合中文表达习惯，可理解为“超级数据库”或保持原样作为项目名使用） （免费版，500MB）
霓虹（免费套餐，含10GB）
铁路（免费套餐，含5GB）
Heroku Postgres （免费版，1GB）

🔐 认证设置

1. 创建Stytch账户

首选 stytch.com（该网址可直接译为“Stytch官网”，但具体翻译可能需根据网站实际内容和语境调整，此处为直译）并进行注册（提供免费层级）
创建一个新项目（例如，“MCP 试验 01”）
导航至 API密钥 部分；章节
复制你的 项目编号 并且秘密

2. 配置OAuth回调

在Stytch仪表板中：

首选 重定向URL
地址： http://localhost:3000/auth/callback
保存设置

3. 获取Google AI密钥

首选 ai.google.dev
点击“获取API密钥”
创建或选择一个项目
复制您的API密钥

⚙️ 配置

创建 .env 项目根目录下的文件：

# Database Connection
DATABASE_URL="postgresql://username:password@localhost:5432/mcp_trial"

# Stytch Authentication
STYTCH_PROJECT_ID="your_stytch_project_id"
STYTCH_SECRET="your_stytch_secret"

# Google AI (Gemini)
GEMINI_API_KEY="your_gemini_api_key"

# OAuth Callback Server (default: 3000)
OAUTH_PORT=3000

安全提示： 永远不要承诺 .env 去吧！它已经在了 .gitignore。

初始化数据库

# Run Prisma migrations to create tables
npm run db:migrate

# This creates:
# ✅ users (authentication data)
# ✅ sessions (login sessions)
# ✅ permissions (permission definitions)
# ✅ user_permissions (user-permission mapping)
# ✅ audit_logs (activity tracking)
# ✅ mcp_users (MCP tool data)

# (Optional) Import sample users from JSON
npm run db:import

🎮 使用方法

认证服务器（生产环境）

使用Stytch + PostgreSQL进行全面认证：

# Start authenticated interactive client
npm run client:interactive

# What happens:
# 1. Enter your email
# 2. Check your inbox for magic link
# 3. Click the link (opens browser)
# 4. Automatic login in terminal
# 5. Interactive menu appears

# Menu options:
# ❯ 👤 Create user
#   🎲 Create random user
#   👥 View all users
#   🔧 List available tools
#   📚 List available resources
#   🚪 Logout

直接服务器访问：

# Run authenticated server directly (for debugging)
npm run server:auth:direct

# Get authentication token
npm run auth:get-token

🧪 基础服务器（开发/测试）

简单的MCP服务器（无认证）：

# Run basic server
npm run server:dev

# Run basic client
npm run client:dev

# Use MCP Inspector (visual debugging)
npm run server:inspect

📱 交互式客户端功能

🎯 What would you like to do?

❯ 👤 Create user
  • Enter name, email, address, phone
  • Validates all inputs
  • Saves to PostgreSQL via Prisma
  • Returns user ID and confirmation

  🎲 Create random user
  • Generates realistic fake data
  • Unique emails with timestamps
  • Automatic phone formatting
  • Instant database insertion

  👥 View all users
  • Shows all users in database
  • Formatted JSON output
  • Ordered by creation date
  • Requires 'resources.users' permission

  🔧 List available tools
  • Shows all MCP tools you can use
  • Displays required permissions
  • Interactive tool selection

  📚 List available resources
  • Shows all data resources
  • URI format examples
  • Permission requirements

  🚪 Logout
  • Ends current session
  • Clears authentication token
  • Stops OAuth callback server

文档指南

这个项目包括 15+份全面指南 涵盖认证、Prisma以及MCP的实现。

🎯 快速导航

需求	阅读此内容	时间
快速上手	`START-HERE.md`	5分钟
添加身份验证	`TUTORIAL-STEP-BY-STEP.md`	45-60 分钟
迁移到Prisma	`QUICK-START-POSTGRES.md`	5分钟
深入了解Prisma	`PRISMA-MIGRATION-GUIDE.md`	30 分钟
视觉架构图	`PRISMA-VISUAL-GUIDE.md`	15分钟
修复权限错误	`PERMISSION-FIX.md`	5分钟
命令参考	`QUICK-REFERENCE.md`	参考文献
排查解决问题	`SETUP-AND-TESTING-GUIDE.md`	需要时使用

完整的文件清单

认证教程：

START-HERE.md - 概述与入门指南
TUTORIAL-STEP-BY-STEP.md - 完整的身份验证教程（步骤0-5）
TUTORIAL-PART-2.md - 创建授权码（步骤6-8）
TUTORIAL-PART-3.md - 集成与测试（步骤9-11）
AUTHENTICATION-DEEP-DIVE.md - 高级认证概念
AUTHENTICATION-FAQ.md - 常见问题及解答
PERMISSION-FIX.md - 解决权限问题

棱镜与数据库：

PRISMA-COMPLETE-GUIDE.md - Prisma指南目录
QUICK-START-POSTGRES.md - 5分钟的Prisma迁移
PRISMA-MIGRATION-GUIDE.md - 完成带有语法的Prisma教程
PRISMA-VISUAL-GUIDE.md - 架构图和数据流
MIGRATION-CHECKLIST.md - 分步骤迁移检查清单

MCP实施：

ARCHITECTURE-EXPLAINED.md - 系统架构概述
AUTHENTICATED-SERVER-UPDATED.md - 服务器迁移到Prisma
EXPRESS-API-EXPLAINED.md - OAuth回调服务器详细信息
INTERACTIVE-CLIENT-GUIDE.md - 客户实施指南

参考指南：

QUICK-REFERENCE.md - 所有命令速查表
COMMANDS-REFERENCE.md - 详细的命令说明
SETUP-AND-TESTING-GUIDE.md - 完成设置及故障排除

🚀 建议的学习路径

1️⃣ START-HERE.md (5 min)
   ↓ Understand what you're building

2️⃣ QUICK-START-POSTGRES.md (5 min)
   ↓ Migrate to PostgreSQL + Prisma

3️⃣ TUTORIAL-STEP-BY-STEP.md (45-60 min)
   ↓ Add Stytch authentication

4️⃣ Run client:interactive
   ↓ Test the complete system

5️⃣ PRISMA-MIGRATION-GUIDE.md (30 min)
   ↓ Deep dive into Prisma concepts

6️⃣ Build your own features! 🎉

______________________________________________________________________

🏗️ MCP 服务器组件

🔧 修理工具/扳手（或根据上下文可译为“维修工具”等）工具（受权限保护）

`create-user`

在 PostgreSQL 数据库中创建一个新用户。

需要权限： tools.create-user

输入模式（或输入架构）：

{
  name: string; // Full name (required)
  email: string; // Valid email format (unique)
  address: string; // Complete address (required)
  phone: string; // Phone number (required)
}

示例：

{
  "name": "Jane Doe",
  "email": "jane@example.com",
  "address": "456 Oak Ave, Springfield 62701",
  "phone": "(555) 987-6543"
}

回答：

{
  "success": true,
  "message": "User created successfully",
  "user": {
    "id": 5,
    "name": "Jane Doe",
    "email": "jane@example.com",
    "createdAt": "2025-10-20T10:30:00.000Z"
  },
  "createdBy": "admin@example.com"
}

`create-random-user`

生成并保存逼真的虚假用户数据。

需要权限： tools.create-random-user

无需输入 - 自动生成：

逼真的姓名组合（50多个名字，50多个姓氏）
多种电子邮件域名（@gmail.com、@yahoo.com、@outlook.com 等）
带有门牌号和邮政编码的真实地址
格式正确的美国电话号码
带有时间戳的唯一电子邮件，以防止重复

回应：

{
  "success": true,
  "user": {
    "id": 6,
    "name": "Michael Chen",
    "email": "mchen_483921@gmail.com",
    "address": "789 Pine St, Austin 78701",
    "phone": "(555) 234-5678",
    "createdAt": "2025-10-20T10:31:00.000Z"
  }
}

📚 书籍资源（受权限保护）

`users://all`

从 PostgreSQL 中返回所有用户的完整列表。

需要权限： resources.users 或者 resources.users.read

URI: （统一资源标识符，通常用于标识网络上的资源） users://all

回答：

[
  {
    "id": 1,
    "name": "John Smith",
    "email": "john@example.com",
    "address": "123 Main St, Springfield 62701",
    "phone": "(555) 123-4567",
    "createdAt": "2025-10-19T15:20:00.000Z",
    "updatedAt": "2025-10-19T15:20:00.000Z"
  }
  // ... more users
]

`users://{userId}/profile`

根据用户ID返回特定用户的详细信息。

需要权限： resources.user-details

URI:（统一资源标识符，通常用于唯一标识互联网上的资源） users://5/profile

回答：

{
  "id": 5,
  "name": "Jane Doe",
  "email": "jane@example.com",
  "address": "456 Oak Ave, Springfield 62701",
  "phone": "(555) 987-6543",
  "createdAt": "2025-10-20T10:30:00.000Z",
  "updatedAt": "2025-10-20T10:30:00.000Z"
}

💬（表示某种情绪或话题的符号，无直接对应中文翻译，可保持原样或根据上下文具体解释）提示（AI生成模板）

`generate-fake-user`

适用于Google Gemini的AI驱动用户生成提示。

参数：

name （可选）：要使用的具体名称
style （可选）：生成风格

- professional公司电子邮件，正式地址 - casual常见提供者，简单格式化（默认） - international多种名称和格式

使用示例：

const prompt = await mcp.getPrompt({
  name: "generate-fake-user",
  arguments: { style: "professional" },
});
// Returns prompt template for AI to generate user data

🎭 客户功能

🔐 认证流程

1. User enters email
   ↓
2. Stytch sends magic link to inbox
   ↓
3. User clicks link (opens browser)
   ↓
4. OAuth callback server captures token
   ↓
5. Token stored for MCP requests
   ↓
6. Interactive menu appears
   ↓
7. All requests include token in header
   ↓
8. Server validates token with Stytch
   ↓
9. Permissions checked before execution
   ↓
10. Audit log created for each action

🤖 表情符号，通常代表机器人或人工智能。人工智能集成

Google Gemini使用MCP工具进行函数调用
流媒体支持实时响应生成
情境感知AI了解可用的工具和资源
错误恢复自动重试并提供有用建议

✅ 输入验证

电子邮件验证符合RFC规范的格式检查
电话号码验证美国格式，支持灵活输入（接受多种格式）
重试逻辑最多尝试3次，每次都会提供有用的错误信息
类型安全完整的 TypeScript + Zod 模式验证
重复检测防止数据库中出现重复邮件

🎮 表示游戏（Play）交互式菜单系统

@inquirer/prompts（可译为“用于询问的提示模块”或根据具体上下文调整）漂亮的命令行界面
清晰导航易于使用的菜单选项
实时反馈加载指示器和成功消息
错误处理优雅的错误显示并提供恢复选项
会话管理持续登录直至登出

数据库管理

棱镜命令

# Create and apply migrations
npm run db:migrate
# or: npx prisma migrate dev --name your_migration_name

# Open Prisma Studio (visual database browser)
npm run db:studio

# Regenerate Prisma Client (after schema changes)
npm run db:generate

# Reset database (⚠️ DESTRUCTIVE - deletes all data)
npm run db:reset

# Import users from JSON to PostgreSQL
npm run db:import

Prisma Studio（普里斯玛工作室）

可视化数据库浏览器 http://localhost:5555:

✅ 查看所有表格和数据
✅ 直接编辑记录
✅ 使用表单验证添加新记录
✅ 删除记录
✅ 过滤和搜索数据
✅ 查看表之间的关系

发射；启动 npm run db:studio

数据库模式

您的 PostgreSQL 数据库包含：

表格	目的	关键字段
`users`	认证数据	邮箱，stytch用户ID，创建时间
`sessions`	登录会话	sessionToken, expiresAt
`permissions`	权限定义	名称、类别、描述
`user_permissions`	用户-权限映射	userId，permissionId
`audit_logs`	活动追踪	userId（用户ID）、action（操作）、resourceType（资源类型）
`mcp_users`	MCP工具用户数据	姓名、电子邮件、地址、电话

迁移历史

迁移数据存储在 prisma/migrations/：

20251018111717_init/ - 初始模式，包含认证表
20251020143059_add_mcp_users/ - 添加了mcp_users表

🛠️ 脚本与工具

用户管理脚本

位于 scripts/ 目录：

# Import users from JSON to PostgreSQL
npx tsx scripts/importUsers.ts

# View audit logs (all user activity)
npx tsx scripts/viewAuditLogs.ts

# Delete a user and all related data
npx tsx scripts/deleteUser.ts

审计日志

查看所有用户活动：

npx tsx scripts/viewAuditLogs.ts

# Example output:
# 📋 Audit Logs (Last 50):
# ────────────────────────────────────────────────
# 🔧 TOOL_CALL: create-random-user
#    User: admin@example.com
#    Time: 2025-10-20 10:30:15
#    Result: SUCCESS
#
# 📚 RESOURCE_ACCESS: users://all
#    User: admin@example.com
#    Time: 2025-10-20 10:31:42
#    Result: SUCCESS

🔧 VS Code 集成

在VS Code中添加MCP服务器

打开命令面板 (Ctrl+Shift+P 或者 Cmd+Shift+P）

搜索“MCP: 添加服务器”

配置服务器：

   {
     "name": "mcp-trial-01-auth",
     "command": "npx",
     "args": ["tsx", "src/authenticated_server.ts"],
     "cwd": "C:\\Users\\YourName\\path\\to\\mcp-trial-01",
     "env": {
       "MCP_ACCESS_TOKEN": "your_stytch_token_here"
     }
   }

验证安装“MCP: 显示服务器”

获取您的访问令牌

# Method 1: Run authenticated client once
npm run client:interactive
# After login, token is displayed in console

# Method 2: Get token programmatically
npm run auth:get-token

与VS Code AI聊天功能一起使用

一旦配置好您的访问令牌，所有MCP工具都将可在VS Code的AI聊天中使用：

You: Create a random user
AI: [Calls create-random-user tool via MCP]
    ✅ Created user: Michael Chen (mchen_483921@gmail.com)

You: Show all users
AI: [Accesses users://all resource]
    📋 Found 12 users in database

📚 API 参考

环境变量

# Required
DATABASE_URL="postgresql://user:pass@localhost:5432/dbname"
STYTCH_PROJECT_ID="project-test-xxx"
STYTCH_SECRET="secret_test_xxx"
GEMINI_API_KEY="AIzaSyXXX"

# Optional
OAUTH_PORT=3000              # OAuth callback server port
NODE_ENV=development         # Environment mode

🛠️ 开发

项目结构

mcp-trial-01/
├── src/
│   ├── authenticated_server.ts    # Production MCP server (Prisma + Stytch)
│   ├── authenticated_client.ts    # Interactive auth client
│   ├── server.ts                  # Basic MCP server (JSON storage)
│   ├── client.ts                  # Basic MCP client
│   ├── interactive_client.ts      # Menu-driven client
│   ├── auth/
│   │   ├── authMiddleware.ts      # Token validation
│   │   └── authorizationService.ts # Permission checks
│   └── data/
│       └── users.json             # Legacy JSON storage
├── prisma/
│   ├── schema.prisma              # Database schema
│   └── migrations/                # Migration history
├── scripts/
│   ├── importUsers.ts             # JSON to PostgreSQL import
│   ├── viewAuditLogs.ts           # View activity logs
│   └── deleteUser.ts              # Delete user utility
├── build/                         # Compiled JavaScript
├── package.json                   # Dependencies and scripts
├── tsconfig.json                  # TypeScript configuration
└── .env                           # Environment variables (not in git)

可用脚本

# Build
npm run build                    # Compile TypeScript

# Servers
npm run server:dev               # Basic server (JSON storage)
npm run server:auth:direct       # Authenticated server (direct run)
npm run server:inspect           # MCP Inspector (debugging)

# Clients
npm run client:dev               # Basic client
npm run client:interactive       # Interactive menu client (auth)
npm run auth:get-token           # Get authentication token

# Database
npm run db:migrate               # Create/apply migrations
npm run db:studio                # Open Prisma Studio
npm run db:generate              # Regenerate Prisma Client
npm run db:import                # Import JSON users to PostgreSQL
npm run db:reset                 # Reset database (⚠️ DESTRUCTIVE)

开发工作流程

进行模式更改 在里面 prisma/schema.prisma
创建迁移： npm run db:migrate
在 Prisma Studio 中验证： npm run db:studio
更新服务器代码 在 src/authenticated_server.ts
与客户端进行测试： npm run client:interactive
检查审计日志： npx tsx scripts/viewAuditLogs.ts

测试策略

# 1. Test basic MCP functionality
npm run server:dev
npm run client:dev

# 2. Test Prisma queries
npm run db:studio

# 3. Test authentication flow
npm run client:interactive

# 4. Test permissions
# Try accessing tools without proper permissions

# 5. Test audit logging
npx tsx scripts/viewAuditLogs.ts

# 6. Test with MCP Inspector (visual debugging)
npm run server:inspect

🤝 贡献（或“参与贡献”）

我们欢迎投稿！以下是投稿指南：

开发环境设置

# 1. Fork and clone
git clone https://github.com/YOUR_USERNAME/mcp-trial-01.git
cd mcp-trial-01

# 2. Install dependencies
npm install

# 3. Setup development environment
cp .env.example .env
# Add your API keys and database URL

# 4. Setup database
npm run db:migrate

# 5. Test your changes
npm run client:interactive

代码风格

启用严格模式的TypeScript
使用 Prettier 进行格式化
遵循现有的代码模式
为公共函数添加JSDoc注释
包含错误处理

要做出什么贡献

🐛 错误修复
✨ 新的MCP工具或资源
📚 文档改进
🎨 用户界面/用户体验改进
🧪 测试覆盖率
🌍 国际化

🙏 致谢

框架与工具

模型上下文协议 - 优秀的MCP框架
棱镜 - 现代数据库工具包
PostgreSQL（译文：波斯特格瑞斯尔/波斯特格瑞斯库尔，但通常直接称为“PostgreSQL”，不翻译） - 强大的开源数据库
Stytch - 无密码认证平台
谷歌人工智能 - Gemini API 集成
Vercel AI SDK（软件开发工具包） - 通用人工智能框架
佐德 - 以TypeScript为先的模式验证
Express.js - OAuth回调服务器
询问者 - 交互式命令行界面提示

特别感谢

MCP社区因其出色的文档和示例而备受赞誉
Stytch团队提供的全面身份验证文档
Prisma团队，致力于类型安全的数据库访问
该项目的所有贡献者和用户

📊 项目统计

代码行数： 3,000+（TypeScript）
数据库表： 6（用户、会话、权限、审计日志、MCP用户）
MCP 工具： 2（创建用户，创建随机用户）
MCP Resources（公司名，可译为“MCP资源公司”） 2（用户://全部，用户://{id}/个人资料）
认证： Stytch 与 Prisma 的魔法链接
TypeScript:（可翻译为“TypeScript（类型脚本）:”） 严格模式，提供完全的类型安全性

______________________________________________________________________

使用模型上下文协议，满怀爱意地构建

](https://github.com/mariemMoula/mcp-trial-01/stargazers) ](https://github.com/mariemMoula/mcp-trial-01/network/members) ](https://github.com/mariemMoula/mcp-trial-01/issues)

如果这个项目对您有所帮助，请考虑给它一个⭐（星标）！

MCP Trial 01

快速接入

详细介绍

🚀 MCP 试验 01 - 认证用户管理系统

📋 目录

✨ 特点

🔐（锁形符号，常用于表示密码或保密） 企业认证

🏗️ 代表“建筑工地”或“正在建造中”。 MCP服务器功能

🎭 表情符号“🎭”的中文翻译可以是“戏剧面具”或“表演面具”，它通常用来表示戏剧、表演或娱乐相关的主题。 交互式客户端

🚀 快速入门

🏛️ 建筑学

两种用户模型

📋 先决条件

🚀 安装

🗄️ 数据库设置

选项1：本地PostgreSQL（推荐用于开发）

选项2：托管PostgreSQL（推荐用于生产环境）

🔐 认证设置

1. 创建Stytch账户

2. 配置OAuth回调

3. 获取Google AI密钥

⚙️ 配置

初始化数据库

🎮 使用方法

认证服务器（生产环境）

🧪 基础服务器（开发/测试）

📱 交互式客户端功能

文档指南

🎯 快速导航

完整的文件清单

🚀 建议的学习路径

🏗️ MCP 服务器组件

🔧 修理工具/扳手（或根据上下文可译为“维修工具”等） 工具 （受权限保护）

create-user

create-random-user

📚 书籍 资源 （受权限保护）

users://all

users://{userId}/profile

💬（表示某种情绪或话题的符号，无直接对应中文翻译，可保持原样或根据上下文具体解释） 提示 （AI生成模板）

generate-fake-user

🎭 客户功能

🔐 认证流程

🤖 表情符号，通常代表机器人或人工智能。 人工智能集成

✅ 输入验证

🎮 表示游戏（Play） 交互式菜单系统

数据库管理

棱镜命令

Prisma Studio（普里斯玛工作室）

数据库模式

迁移历史

🛠️ 脚本与工具

用户管理脚本

审计日志

🔧 VS Code 集成

在VS Code中添加MCP服务器

获取您的访问令牌

与VS Code AI聊天功能一起使用

📚 API 参考

环境变量

🛠️ 开发

项目结构

可用脚本

开发工作流程

测试策略

🤝 贡献（或“参与贡献”）

开发环境设置

代码风格

要做出什么贡献

🙏 致谢

框架与工具

特别感谢

📊 项目统计

使用模型上下文协议，满怀爱意地构建

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

🔐（锁形符号，常用于表示密码或保密）企业认证

🎭 表情符号“🎭”的中文翻译可以是“戏剧面具”或“表演面具”，它通常用来表示戏剧、表演或娱乐相关的主题。交互式客户端

🔧 修理工具/扳手（或根据上下文可译为“维修工具”等）工具（受权限保护）

`create-user`

`create-random-user`

📚 书籍资源（受权限保护）

`users://all`

`users://{userId}/profile`

💬（表示某种情绪或话题的符号，无直接对应中文翻译，可保持原样或根据上下文具体解释）提示（AI生成模板）

`generate-fake-user`

🤖 表情符号，通常代表机器人或人工智能。人工智能集成

🎮 表示游戏（Play）交互式菜单系统