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。