使用说明
一切MCP
概述
一切MCP 是一个集成的项目 一切 (Voidtools),一个适用于Windows的超快速文件搜索引擎,作为 MCP(模型上下文协议) 服务器。这使得可以通过Claude Desktop、OpenAI ChatGPT等MCP客户端在本地系统上进行自然语言文件搜索。
它使用Node.js/TypeScript构建,可以通过npm轻松安装和运行,而不需要单独安装Python。
特性
| 特性 | 描述 |
|---|---|
everything_search(query) |
通过Everything CLI进行超快速文件/文件夹搜索(es.exe) |
everything_open(path) |
使用默认应用程序打开搜索到的文件/文件夹(仅限Windows) |
everything_glob(folder, pattern) |
执行基于文件夹的通配符搜索 |
quick_index_prompt(topic) |
根据搜索结果生成摘要提示 |
先决条件
-
Node.js安装 (v18或更高版本)
-
一切安装
-
Everything CLI(
es.exe)安装-
https://www.voidtools.com/support/everything/command_line_interface/
-
添加
es.exe到PATH或在中指定绝对路径ES_PATH变量insrc/index.ts -
启用Everything Service并构建初始索引
-
快速开始
使用npx(推荐-无需安装)
npx everything-mcp
这将自动下载并运行最新版本。在MCP客户端中注册它(请参阅下面的设置说明)。
本地开发
# 1. Clone the repository
git clone https://github.com/chahero/everything-mcp.git
cd everything-mcp
# 2. Install dependencies
npm install
# 3. Build TypeScript
npm run build
# 4. Run the server
npm start
或者在开发模式下:
npm run dev
使用Claude Desktop进行设置
方法1:使用npx(推荐)
-
打开Claude桌面配置文件
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json
- 窗户:
-
添加以下配置:
{ "mcpServers": { "everything-mcp": { "command": "npx", "args": ["everything-mcp"] } } } -
重新启动克劳德桌面
- 保存配置文件并完全重新启动Claude Desktop。
-
验证连接
- 在Claude Desktop中开始新的对话。您应该在左下角看到连接的“everything mcp”服务器。
方法2:使用本地路径(如果您克隆了存储库)
-
打开Claude桌面配置文件
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json
- 窗户:
-
添加以下配置:
{ "mcpServers": { "everything-mcp": { "command": "node", "args": ["C:\\path\\to\\everything-mcp\\dist\\index.js"] } } }替换
C:\\path\\to\\everything-mcp使用克隆存储库的实际路径。 -
重新启动克劳德桌面
- 保存配置文件并完全重新启动Claude Desktop。
-
验证连接
- 在Claude Desktop中开始新的对话。您应该在左下角看到连接的“everything mcp”服务器。
扩展思路
- 启用用于REST API集成的Everything HTTP服务器
- 结合Naver API、Gemini API、OpenAI API构建混合搜索MCP
- 与RAG(检索增强生成)搜索管道集成
项目结构
everything-mcp/
├── src/
│ └── index.ts # MCP server main code (TypeScript)
├── dist/ # Compiled JavaScript (generated after build)
├── package.json # npm package configuration
├── tsconfig.json # TypeScript configuration
├── README.md # Project documentation
└── .gitignore # Git ignore rules
局限性
- 仅限Windows(仅限于支持Everything的操作系统)
es.exe必须具有管理员权限才能访问管理员索引路径- 仅在UTF-8编码环境中保证完整功能
发展信息
- 运行时:Node.js 18+
- 语言:TypeScript 5.0+
- MCP-SDK: @模型上下文协议/sdk
- Everything CLI文档: https://www.voidtools.com/support/everything/command_line_interface/
许可证
MIT许可证——可自由修改和分发。
