local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Supports .gitignore-style file exclusion patterns through the IGNORE_FILE configuration to control which files are indexed.
Supports indexing and searching Markdown files, allowing semantic queries across Markdown document content.

@lishenxydlgzs/シンプルファイルベクターストア

ファイル全体にわたるセマンティック検索機能を提供するモデルコンテキストプロトコル（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 デスクトップアプリ: ~/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": []
    }
  }
}

ウォッチ構成ファイルの構造は次のようになります。

{
  "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": "500",
          "IGNORE_FILE": "/path/to/.gitignore"
        },
        "disabled": false,
        "autoApprove": []
      }
    }
  }

MCPツール

このサーバーは、次の MCP ツールを提供します。

1. 検索

インデックス化されたファイル全体でセマンティック検索を実行します。

パラメータ:

query （必須）: 検索クエリ文字列
limit (オプション): 返される結果の最大数 (デフォルト: 5、最大: 20)

応答例:

[
  {
    "content": "matched text content",
    "source": "/path/to/file",
    "fileType": "markdown",
    "score": 0.85
  }
]

2. get_stats

インデックス化されたファイルに関する統計を取得します。

パラメータ: なし

応答例:

{
  "totalDocuments": 42,
  "watchedDirectories": ["/path/to/docs"],
  "processingFiles": []
}

特徴

リアルタイムのファイル監視とインデックス作成
ベクトル埋め込みを用いたセマンティック検索
複数のファイル形式のサポート
設定可能なチャンクサイズとオーバーラップ
ファイルのバックグラウンド処理
ファイルの変更と削除の自動処理

リポジトリ

GitHubリポジトリ

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

ディレクトリのリストを監視し、ディレクトリ内のすべてのマークダウン、HTML、テキストファイルをベクターストアに自動的にインデックス付けしてコンテキストを強化する機能を備えた、非常にシンプルなベクターストアです。

Related Resources

Reddit Discussion about this server

Simple Files Vector Store Server