@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）的文件内容分析
• 提供高效的语义搜索能力
• 具备可扩展性，支持大量文档的索引和检索