Ve Nextjs MCP Server

🚀 带有Clerk身份验证的MCP服务器

这是一个基于Next.js的模型上下文协议（MCP）服务器，集成了Clerk身份验证和用户特定的API密钥管理功能，为开发者提供了安全且便捷的使用体验。

🚀 快速开始

1. 克隆并安装

git clone [repository-url]
cd ve-nextjs-mcp-server
npm install

2. 配置Clerk

具体说明请参考 PROJECT_DOCUMENTATION.md：

• 创建Clerk账户和应用程序。
• 在Clerk控制台中禁用注册功能。
• 将环境变量复制到 .env.local 文件中。

3. 启动开发服务器

npm run dev

4. 访问控制台

• 访问 http://localhost:3000。
• 使用授权账户登录。
• 创建用于访问MCP的API密钥。

✨ 主要特性

• 🔐 Clerk身份验证：仅允许登录用户访问，提供严格的访问控制。
• 🗝️ API密钥管理：支持用户创建和管理特定的API密钥。
• ⚙️ MCP集成：与Next.js文档工具集成，提供即用型MCP服务器。
• 🛡️ 多种身份验证方法：支持用户密钥、带PKCE（代码交换证明密钥）的OAuth 2.1和Bearer令牌。
• 📱 响应式控制台：拥有现代的用户界面，方便进行密钥管理。

📦 安装指南

1. 克隆仓库：

git clone [repository-url]

2. 进入项目目录：

cd ve-nextjs-mcp-server

3. 安装依赖：

npm install

💻 使用示例

基础用法

在控制台创建API密钥后，可使用以下命令进行API调用：

# 先在控制台创建API密钥，然后执行以下命令：
curl -X POST http://localhost:3000/api/mcp \
  -H "Authorization: Bearer mcp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_nextjs_docs",
      "arguments": {"topic": "app router"}
    },
    "id": 1
  }'

📚 详细文档

• PROJECT_DOCUMENTATION.md：为AI代理和开发者提供完整的项目文档。
• examples/：包含身份验证示例和客户端代码。

🔧 技术细节

安全特性

• ✅ 仅允许登录用户访问（无公开注册）。
• ✅ 由管理员控制用户管理。
• ✅ 用户隔离的API密钥。
• ✅ 作用域权限。
• ✅ 安全的密钥生成。

如需完整文档，请参阅 PROJECT_DOCUMENTATION.md。