Supavec MCP Server

Supavec MCP サーバー

Supavec から関連する埋め込み表現とコンテンツを取得できる、Model Context Protocol (MCP) サーバーです。

特長

• 🔍 埋め込み表現の取得：埋め込み表現を使用して Supavec のファイル内を検索し、関連するコンテンツを取得します
• 🤖 AI 連携：Cursor、Claude、VS Code Copilot、その他の MCP 対応ツールで使用できます
• 🔑 柔軟な認証：コマンドライン引数と環境変数の両方に対応しています
• ⚡ 簡単なセットアップ：npx を使って、1 つのコマンドでインストールできます

インストール

npx ですぐに開始（推奨）

インストールは不要です！npx を使って直接実行できます。

npx @supavec/mcp-server --api-key your_api_key

グローバルインストール

npm install -g @supavec/mcp-server
supavec-mcp --api-key your_api_key

設定

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "supavec": {
      "command": "npx",
      "args": [
        "-y",
        "@supavec/mcp-server@latest",
        "--api-key",
        "your_supavec_api_key"
      ]
    }
  }
}

VS Code（Copilot）

.vscode/mcp.json に追加します。

{
  "servers": {
    "supavec": {
      "command": "npx",
      "args": [
        "-y", 
        "@supavec/mcp-server@latest",
        "--api-key",
        "your_supavec_api_key"
      ]
    }
  }
}

Claude Desktop

Claude の設定に追加します。

{
  "mcpServers": {
    "supavec": {
      "command": "npx",
      "args": [
        "-y",
        "@supavec/mcp-server@latest", 
        "--api-key",
        "your_supavec_api_key"
      ]
    }
  }
}

環境変数

または、API キーを環境変数として設定します。

export SUPAVEC_API_KEY=your_supavec_api_key

その後、--api-key 引数を指定せずに MCP の設定で使用します。

{
  "mcpServers": {
    "supavec": {
      "command": "npx",
      "args": ["-y", "@supavec/mcp-server@latest"]
    }
  }
}

認証

API キーの取得

1. Supavec にアクセスします
2. アカウントに登録するか、ログインします
3. API 設定に移動します
4. 新しい API キーを生成します

使用される優先順位

サーバーは次の優先順位で API キーを確認します。

1. --api-key コマンドライン引数（最優先）
2. SUPAVEC_API_KEY 環境変数

利用可能なツール

fetch-embeddings

ファイル ID とクエリを指定して、ファイルの埋め込み表現を取得します。

パラメーター：

• file_id（文字列、必須）：埋め込み表現を取得するファイルの ID
• query（文字列、必須）：ファイル内を検索するクエリ

例：

Ask your AI assistant: "Using Supavec, find information about 'authentication' in file abc123"

list-user-files

現在のユーザーが Supavec にアップロードしたすべてのファイルを一覧表示します。

パラメーター：

• limit（数値、任意）：取得するファイル数（デフォルト：10）
• offset（数値、任意）：ページネーションのオフセット（デフォルト：0）
• order_dir（文字列、任意）：結果の並び順。「asc」または「desc」（デフォルト：「desc」）

例：

Ask your AI assistant: "List my Supavec files" or "Show me the first 20 files from my Supavec account"

レスポンスに含まれる内容：

• ファイル ID と名前
• ファイルの種類と作成日
• チーム ID
• ページネーション情報

コマンドラインでの使用方法

ヘルプ

supavec-mcp --help

API キーを指定する場合

supavec-mcp --api-key your_api_key_here

環境変数を使用する場合

export SUPAVEC_API_KEY=your_api_key_here
supavec-mcp

使用例

Cursor での使用

1. .cursor/mcp.json で Supavec MCP を設定します
2. Cursor を開き、新しいチャットを開始します
3. 「Supavec のファイル xyz789 から『database setup』に関する情報を検索してください」 と尋ねます
4. AI が Supavec MCP を使って関連するコンテンツを取得します

Claude での使用

1. Claude の設定で Supavec MCP を設定します
2. 会話の中で 「ファイル abc123 から API エンドポイントに関するドキュメントを探してください」 と尋ねます
3. Claude が Supavec のファイルを検索し、関連情報を返します

トラブルシューティング

よくある問題

「Error: Supavec API key is required」

• --api-key または SUPAVEC_API_KEY 環境変数を使って API キーを指定したことを確認してください

「Failed to fetch data: status 401」

• API キーが無効か、期限切れの可能性があります。Supavec アカウントの設定を確認してください

「Failed to fetch data: status 404」

• ファイル ID が存在しないか、ファイルへのアクセス権がない可能性があります

デバッグモード

環境変数を設定して実行すると、詳細を確認できます。

DEBUG=1 supavec-mcp --api-key your_key

開発

要件

• Node.js 16.0.0 以上
• TypeScript

セットアップ

git clone https://github.com/supavec/mcp-server.git
cd supavec-mcp-server
npm install
npm run build

テスト

# Test with MCP Inspector
npm run inspector

# Test command line
npm run build
node build/index.js --help

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します：git checkout -b feature-name
3. 変更を加え、テストを追加します
4. 変更をコミットします：git commit -am 'Add feature'
5. ブランチにプッシュします：git push origin feature-name
6. プルリクエストを送信します

ライセンス

MIT License — 詳細は LICENSE を参照してください。

サポート

• 📚 Supavec のドキュメント
• 🐛 問題を報告
• 💬 コミュニティサポート

Related

• Model Context Protocol
• Supavec Platform
• MCP Servers