使用说明
mcp.shop
The world's first MCP-based web shop, built with WorkOS AuthKit and Next.js mcp-adaptor.
Live Demo • Overview • Architecture • Prerequisites • Setup
概述
这个项目展示了如何使用AuthKit与MCP(可能是指某种中间件或认证平台)来创建一个安全的网络商店,用户可以在其中:
- 连接到MCP服务器
- 通过AuthKit进行身份验证
- 使用MCP工具订购T恤
- 查看订单详情(仅限管理员用户)
建筑学
该应用程序基于:
- Next.js B2B 起步工具包 对于网站
- Vercel MCP 适配器 用于MCP集成
- WorkOS AuthKit 配合 MCP 使用 用于认证
关键部件:
- 认证逻辑:
lib/with-authkit.ts - 客户端注册:
app/.well-known/ - MCP 实施:
app/[transport]/route.ts
先决条件
- Node.js(建议使用最新LTS版本)
- 已配置AuthKit的WorkOS账户
- Redis 服务(例如,Upstash)
设置
-
克隆仓库
-
安装依赖项:
pnpm install -
配置环境变量:
复制
.env.exampleto.env.local并适当设置每个环境变量。注:
- 你可以在(相应位置)找到你的WorkOS凭据 WorkOS 控制台。
- 确保设置好你的重定向URI(
http://localhost:3000/callback用于本地开发或https://<deployed-url>/callback(用于生产)在仪表盘中。 - 确保您已启用 动态客户端注册 在仪表盘上。它应该位于(某个位置)之下 开发者 -> 应用程序 -> 配置 仪表盘上的页面
-
启动开发服务器:
pnpm dev该应用程序将在以下地址提供:
连接到MCP
要将您的聊天客户端连接到开发服务器,请在您的MCP配置文件中添加以下配置(例如。, .cursor/mcp.json):
{
"mcpServers": {
"mcp.shop": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:3000/mcp"]
}
}
}
做出贡献
欢迎贡献!请随时提交拉取请求。