Supabase Nextjs MCP Server

🚀 使用 Supabase 的 Next.js MCP 服務器

這是一個實現了模型上下文協議（Model Context Protocol，MCP）的服務器。它基於 TypeScript 構建，以一個簡單的 Next.js 筆記系統為示例，展示了核心的 MCP 概念，如使用特定 URI 表示筆記資源、創建新筆記以及生成筆記摘要提示等。

🚀 快速開始

本服務器是一個基於 TypeScript 的 MCP 服務器，通過一個簡單的 Next.js 筆記系統，展示了核心的 MCP 概念。

✨ 主要特性

初始化配置

• 需設置 NEXT_PUBLIC_SUPABASE_URL 和 NEXT_PUBLIC_SUPABASE_ANON_KEY 環境變量。

資源管理

• 可列出和訪問通過 note:// URI 標識的筆記資源。
• 每個筆記包含標題、內容和元數據信息。
• 使用純文本 MIME 類型提供簡單的內容訪問。

工具功能

• create_note：創建新的文本筆記。
  • 接受標題和內容作為必填參數。
  • 在服務器狀態中存儲新筆記。

提示生成

• summarize_notes：生成所有存儲筆記的摘要。
  • 包含所有筆記內容作為嵌入資源。
  • 返回適合大語言模型（LLM）處理的結構化提示。

📦 安裝指南

開發流程

• 安裝依賴項：

npm install

• 構建服務器：

npm run build

• 開發模式下自動重建：

npm run watch

安裝配置

要在 Claude Desktop 中使用，需添加以下服務器配置：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "supabase-nextjs-server": {
      "command": "/path/to/supabase-nextjs-server/build/index.js"
    }
  }
}

使用 Smithery 安裝

通過 Smithery 自動安裝：

npx -y @smithery/cli install @tengfone/supabase-nextjs-mcp-server --client claude

調試工具

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能較為複雜。我們推薦使用 MCP Inspector 進行調試：

npm run inspector

Inspector 會提供一個訪問瀏覽器調試工具的 URL 地址。