Simple File Vector Store

🚀 @lishenxydlgzs/simple-files-vectorstore

このモデルコンテキストプロトコル（MCP）サーバーは、ファイルの意味検索機能を提供します。指定されたディレクトリを監視し、ファイル内容のベクトル埋め込みを生成することで、ドキュメントの意味検索を実現します。

🚀 クイックスタート

📦 インストール

あなたの MCP 設定ファイルに以下を追加してください：

{
  "mcpServers": {
    "files-vectorstore": {
      "command": "npx",
      "args": [
        "-y",
        "@lishenxydlgzs/simple-files-vectorstore"
      ],
      "env": {
        "WATCH_DIRECTORIES": "/path/to/your/directories"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

MCP 設定ファイルの場所：

• VSCode Cline 拡張：~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Claude Desktop アプリケーション：~/Library/Application Support/Claude/claude_desktop_config.json

💻 使用例

基本的な使用法

上記の設定を行った後、サーバーを起動することで、指定されたディレクトリ内のファイルの意味検索が可能になります。

🔧 技術詳細

設定

サーバーは環境変数を通じて設定する必要があります。

必要な環境変数

監視するディレクトリを指定するには、以下のいずれかの方法を使用する必要があります：

• WATCH_DIRECTORIES: カンマ区切りのディレクトリリスト
• WATCH_CONFIG_FILE: watchList 配列を含む JSON 設定ファイルのパス

例（WATCH_DIRECTORIES を使用）：

{
  "mcpServers": {
    "files-vectorstore": {
      "command": "npx",
      "args": [
        "-y",
        "@lishenxydlgzs/simple-files-vectorstore"
      ],
      "env": {
        "WATCH_DIRECTORIES": "/path/to/dir1,/path/to/dir2"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

例（WATCH_CONFIG_FILE を使用）：

{
  "mcpServers": {
    "files-vectorstore": {
      "command": "npx",
      "args": [
        "-y",
        "@lishenxydlgzs/simple-files-vectorstore"
      ],
      "env": {
        "WATCH_CONFIG_FILE": "/path/to/watch-config.json"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

watch 設定ファイルは以下の構造を持つ必要があります：

{
  "watchList": [
    "/path/to/dir1",
    "/path/to/dir2",
    "/path/to/specific/file.txt"
  ]
}

オプションの環境変数

• CHUNK_SIZE: テキストチャンクのサイズ（デフォルト：1000）
• CHUNK_OVERLAP: チャンク間の重複量（デフォルト：200）
• IGNORE_FILE: .gitignore スタイルのファイルパスで、除外するファイル/ディレクトリを指定します

例（すべてのオプションパラメータを含む）：

{
  "mcpServers": {
    "files-vectorstore": {
      "command": "npx",
      "args": [
        "-y",
        "@lishenxydlgzs/simple-files-vectorstore"
      ],
      "env": {
        "WATCH_DIRECTORIES": "/path/to/dir1,/path/to/dir2",
        "CHUNK_SIZE": "2000",
        "CHUNK_OVERLAP": "200",
        "IGNORE_FILE": "/path/to/ignore-file.txt"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

📚 MCP ツール

検索ツール（Search Tool）

名前：search

パラメータ：

• query: 検索するクエリ文字列
• maxResults: 最大返却結果数で、デフォルトは 5

レスポンス：

{
  "results": [
    {
      "id": string,
      "score": number,
      "content": string
    }
  ]
}

例：

curl -X POST http://localhost:1234/mcp/v1/tools/search \
  -H "Content-Type: application/json" \
  -d '{"query":"查询字符串", "maxResults":5}'

✨ 主な機能

• 大規模言語モデル（LLM）によるファイル内容分析をサポート
• 効率的な意味検索機能を提供
• 大量のドキュメントのインデックス作成と検索をサポートする拡張性を備えています