SME Library MCP

AIエージェントが参照できるSME（Subject Matter Expert）プロフィールを作成・検索・共有するための、無料のオープンソースMCPサーバーです。誰でも自分のエージェントを接続し、共有ライブラリから検証済みの専門家プロフィールを取得し、自分のワークスペースに非公開の専門家プロフィールを保持し、モデレーション付きのプロモーションパイプラインを通じて優れたプロフィールを共有ライブラリに還元できます。また、スタック全体をセルフホストすることもできます。

MIT Licenseの下でライセンスされています。issueやプルリクエストでのコントリビューションを歓迎します。

Supabaseバックエンドを備え、Vercel（Next.js + Streamable HTTPトランスポート）上で動作します。はじめての方は、**ユーザーガイド**をお読みください。仕組みの全体に加えて、すべてのSMEフィールドとその値の範囲の完全なリファレンスをまとめています（アプリ内の/guideからも参照できます）。全体の設計とロードマップはARCHITECTURE.mdを、ステップバイステップのデプロイ手順書はdocs/SME_MCP_Implementation_Checklist.pdfを参照してください（docs/implementation-checklist.htmlから再生成できます）。

ツール

Related MCP server: HiveMind

セットアップ

1. Supabase

Supabaseプロジェクトを作成し、マイグレーションを適用します。

supabase link --project-ref <ref>
supabase db push                    # applies supabase/migrations/*.sql
supabase functions deploy embed     # optional: enables semantic/hybrid search

embedエッジファンクションは、組み込みのgte-smallモデルを実行します。これはオプションです。これがない場合、検索は自動的にキーワード全文検索（FTS）にフォールバックします。

2. APIキーを取得する

自己管理（推奨）： /dashboardにアクセスし、アカウントを作成し（Supabase Auth）、キーを発行します。初回ログイン時にワークスペースが自動的に作成されます。SUPABASE_ANON_KEYが設定されており、Supabaseプロジェクトでメール認証が有効になっている必要があります。

管理者／CLI： 管理者キーまたはスクリプトによるプロビジョニングの場合：

SUPABASE_URL=... SUPABASE_SERVICE_ROLE_KEY=... \
  node scripts/create-key.mjs --workspace "My Team"            # read,write key
  node scripts/create-key.mjs --workspace "Ops" --admin        # admin key

どちらの方法でもプレーンテキストのキー（sme_live_...）は一度だけ表示され、保存されるのはそのSHA-256ハッシュのみです。

3. Vercelにデプロイする

vercel deploy

Vercelプロジェクトに環境変数を設定します。SUPABASE_URL、SUPABASE_SERVICE_ROLE_KEY、SUPABASE_ANON_KEY（利根バックエンド）、ANTHROPIC_API_KEY、CRON_SECRET（毎日/api/cron/maintenanceジョブを保護します。このジョブは品質スコアの再計算、レート制限ウィンドウの消去、データの書き戻しを実行します）。また、NEXT_PUBLIC_BASE_URLにMaxの正規URLを設定し、ADMIN_EMAILS（カンマ区切り）で管理者アクセスを初期化します。

3b. メール（確認メールとパスワードリセット）

認証メールはこのアプリではなくSupabaseから送信されます。新しいアカウントが確認メールを受信できない場合は、Supabaseの設定が原因です。その場合、カスタムSMTPが設定されていないことがほとんどです（組み込みの送信者はテスト専用で、1時間にわずか数通に制限されています）。SupabaseダッシュボードでAuthentication → Emails → SMTP Settingsを設定し（Resend/Postmark/SendGrid/SES）、Providers → EmailでConfirm emailを有効にし、URL Configurationの許可リストにサイトのURLと…/auth/callbackを追加してください。

4. クライアントを接続する

claude mcp add --transport http sme-library \
  https://<deployment>/api/mcp \
  --header "Authorization: Bearer sme_live_..."

Claude Code、claude.aiのカスタムコネクタ、およびStreamable-HTTP MCPクライアントで動作します。

ローカル開発

cp .env.example .env      # fill in Supabase + Anthropic
npm install
npm run dev               # HTTP server on :3000 (endpoint: /api/mcp)
SME_API_KEY=sme_live_... npm run stdio   # or stdio transport for local clients

セキュリティモデル

• APIキーは保存時にハッシュ化され（SHA-256）、Authorizationヘッダーでのみ渡されます。認証情報がツールの引数やモデルのコンテキストテキストに現れることはありません。

• すべてのキーは、スコープ（read、write、promote、admin）とレート制限の階級を持つ1つのワークスペースに対応します。キーごとに固定されたウィンドウン制限はPostgresで強制されます。

• Supabase RLSは防御の多層化としてすべてのテーブルでdeny-allが有効になっており、読み取りと書き込みができるのはサーバーのサービスロールクライアントのみです。

• すべての書き込みはaudit_logに記録されます。