supabase-nextjs-server MCP Server について
NextJS向けにテキストノートを管理する、TypeScript製のMCPサーバーの例です。リソース、ノート作成ツール、要約プロンプトでMCPの基本概念を示します。
主な機能
- 01note:// URIでノートを一覧・閲覧
- 02タイトルと本文を指定してノート作成
- 03ノート要約用プロンプトの提供
活用シーン
- 01URIからノート本文を読む
- 02保存済みノートをLLMで要約
MCP 対応
クライアントにノートのリソース、作成ツール、要約プロンプトを公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
supabase-nextjs-server MCP サーバー
Model Context Protocol サーバー
これは、NextJS 用のシンプルなメモシステムを実装した TypeScript ベースの MCP サーバーです。以下を提供することで、MCP の基本概念を示します。
- URI とメタデータを持つテキストメモを表すリソース
- 新しいメモを作成するツール
- メモの要約を生成するプロンプト
特長
初期化
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 経由で、Claude Desktop 用の Supabase Notes を自動的にインストールするには:
npx -y @smithery/cli install @tengfone/supabase-nextjs-mcp-server --client claude
デバッグ
MCP サーバーは標準入出力経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。
npm run inspector
Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。