Ve Nextjs MCP Server

🚀 Clerk認証付きMCPサーバー

Clerk認証とユーザー固有のAPIキー管理を統合した、Next.jsベースのモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

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キーを作成します。

📚 ドキュメント

• PROJECT_DOCUMENTATION.md - AIエージェントと開発者向けの完全なプロジェクトドキュメント
• examples/ - 認証のサンプルとクライアントコード

✨ 主な機能

• 🔐 Clerk認証 - サインインのみのアクセス制御
• 🗝️ APIキー管理 - ユーザー固有のキーの作成と管理
• ⚙️ MCP統合 - Next.jsドキュメントツール付きのすぐに使えるMCPサーバー
• 🛡️ 複数の認証方法 - ユーザーキー、PKCE（Proof Key for Code Exchange）付きのOAuth 2.1、ベアラートークン
• 📱 レスポンシブなダッシュボード - キー管理用のモダンなUI

💻 使用例

基本的な使用法

# まずダッシュボードで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
  }'

🔧 技術詳細

• ✅ サインインのみのアクセス（公開登録なし）
• ✅ 管理者が管理するユーザー管理
• ✅ ユーザー分離されたAPIキー
• ✅ スコープ付きの権限
• ✅ 安全なキー生成

完全なドキュメントについては、PROJECT_DOCUMENTATION.mdを参照してください。