File Finder MCP Server

MCP 服务器

该存储库包含两个 MCP（模型上下文协议）服务器：

1. File Finder MCP - 用于搜索文件
2. Whisper STT MCP - 用于将语音转换为文本

文件查找器 MCP 服务器

这是一个提供文件搜索功能的模型上下文协议 (MCP) 服务器。它允许您搜索名称中包含指定文本片段的文件。

先决条件

• Node.js（版本 14 或更高版本）
• npm（版本 6 或更高版本）
• Python 3.6 或更高版本（用于 HTTP 服务器）

安装

1. 克隆或下载此存储库
2. 进入项目目录
3. 安装依赖项：
   npm install
4. 组装项目：
   npm run build

启动服务器

该项目提供了几种启动 MCP 服务器的选项：

选项 1：直接启动 MCP 服务器

您可以直接使用 Node.js 运行 MCP 服务器：

或者

这将启动服务器并在 stdin/stdout 上监听 JSON-RPC 请求。

选项 2：启动 HTTP 服务器和 MCP 代理

此选项使用 Python HTTP 服务器和将请求转发到 HTTP 服务器的 MCP 代理：

1. 首先，启动 HTTP 服务器：
   npm run start:python
   或者
   python main.py
2. 然后在另一个终端中运行 MCP 代理：
   npm run start:http
   或者
   node build/index-http.js

选项 3：与 VS Code 集成（Cline 扩展）

要将服务器与 VS Code 和 Cline 扩展集成：

1. 查找 MCP 设置文件：
   • Windows： %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   • macOS： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. 在设置文件中的mcpServers对象中添加以下配置：

要使用 HTTP 代理：

将<ПОЛНЫЙ_ПУТЬ_К_ПРОЕКТУ>替换为项目目录的实际路径。

3. 重新启动 VS Code 以加载更新的设置。

可用工具

MCP 服务器提供了一个工具：

• search_files ：搜索名称中包含指定片段的文件
  • 参数：
    • fragment （字符串，必需）：要在文件名中搜索的文本片段

使用示例

此示例查找名称中包含“.py”的所有文件。

HTTP 服务器（main.py）

在项目的根目录下有一个main.py文件，实现了一个用于搜索文件的HTTP服务器。该服务器提供 REST API 来搜索名称中包含指定片段的文件。

启动 HTTP 服务器

1. 进入项目根目录
2. 使用 Python 启动服务器：
   python main.py
3. 服务器将在http://localhost:8080启动

使用 API

要搜索文件，请向/search发送带有q查询参数的 GET 请求：

此查询将返回一个 JSON 数组，其中包含有关名称中包含“.json”的所有文件的信息。每个数组元素包含以下字段：

• name ：文件名
• path ：文件的绝对路径
• size ：文件大小（以字节为单位）
• created ：文件创建的日期和时间

示例答案：

Whisper STT MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，它使用 fastest-whisper 库提供语音转文本功能。它允许您将音频数据转录为文本，并自动检测语言。

先决条件

• Node.js（版本 14 或更高版本）
• npm（版本 6 或更高版本）
• Python 3.6 或更高版本
• fastest-whisper (使用pip install faster-whisper )

安装

1. 克隆或下载此存储库
2. 进入项目目录
3. 安装依赖项：
   npm install pip install faster-whisper
4. 组装项目：
   npm run build

启动服务器

该项目提供了几种运行 Whisper MCP 服务器的选项：

选项 1：直接启动 MCP 服务器

您可以直接使用 Node.js 运行 MCP 服务器：

或者

这将启动服务器并在 stdin/stdout 上监听 JSON-RPC 请求。

选项 2：启动 HTTP 服务器和 MCP 代理

此选项使用 Python HTTP 服务器和将请求转发到 HTTP 服务器的 MCP 代理：

1. 首先，启动 HTTP 服务器：
   npm run start:whisper:python
   或者
   python whisper_server.py
2. 然后在另一个终端中运行 MCP 代理：
   npm run start:whisper:http
   或者
   node build/whisper-index-http.js

选项 3：与 VS Code 集成（Cline 扩展）

要将服务器与 VS Code 和 Cline 扩展集成：

1. 查找 MCP 设置文件：
   • Windows： %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   • macOS： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings\cline_mcp_settings.json
   • Linux： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. 在设置文件中的mcpServers对象中添加以下配置：

要使用 HTTP 代理：

将<ПОЛНЫЙ_ПУТЬ_К_ПРОЕКТУ>替换为项目目录的实际路径。

3. 重新启动 VS Code 以加载更新的设置。

可用工具

MCP 服务器提供了一个工具：

• transcribe_audio ：使用 fastest-whisper 将音频数据转录为文本
  • 参数：
    • audio_base64 （字符串，必需）：base64 格式的音频数据
    • language （字符串，可选）：语言代码（例如“en”，“ru”）。如果未指定，则会自动检测语言。

使用示例

此示例将音频数据转换为文本，假设音频是俄语。

HTTP 服务器（whisper_server.py）

在项目的根目录中有一个文件whisper_server.py ，它实现了一个用于将语音转换为文本的HTTP服务器。该服务器提供 REST API，用于将音频数据转录为文本。

启动 HTTP 服务器

1. 进入项目根目录
2. 使用 Python 启动服务器：
   python whisper_server.py
3. 服务器将在http://localhost:8081启动

使用 API

要转录音频，请向/transcribe发送一个 POST 请求，其中包含以下内容的 JSON 主体：

• audio ：包含音频数据的 base64 编码字符串
• language （可选）：语言代码（例如“en”，“ru”）

示例请求：

答案将包含：

• text ：完整的转录文本
• segments ：带有时间戳的段数组
• language ：特定语言
• language_probability ：检测语言的概率

示例答案：

故障排除

• 如果出现“未找到服务器连接”错误，请确保在更新 MCP 设置后重新启动 VS Code。
• 如果服务器没有响应，请检查 MCP 设置中的路径是否正确并指向编译后的 JavaScript 文件。
• 在尝试使用服务器之前，请通过运行npm run build确保服务器已正确构建。
• 要使用 HTTP 代理，请确保适当的 HTTP 服务器正在运行（file-finder 在端口 8080 上，whisper-stt 在端口 8081 上）。
• 如果您在使用 fastest-whisper 时遇到问题，请确保库已正确安装，并且您具有使用 GPU 所需的依赖项（如果您使用 GPU）。

项目结构

以下是主要项目文件及其用途的列表：

根目录

• src/index.ts - TypeScript MCP 文件搜索服务器源代码（直接实现）
• src/index-http.ts - 用于 HTTP 文件搜索服务器的 TypeScript MCP 代理的源代码
• src/whisper-index.ts - TypeScript MCP 语音转文本服务器源代码（直接实现）
• src/whisper-index-http.ts - 用于 HTTP 语音转文本服务器的 TypeScript MCP 代理的源代码
• build/index.js - 用于搜索文件的 MCP 服务器 JavaScript 代码
• build/index-http.js - 用于搜索文件的 MCP 代理的编译 JavaScript 代码
• build/whisper-index.js - MCP 服务器的 JavaScript 代码编译，用于将语音转换为文本
• build/whisper-index-http.js - 用于将语音转换为文本的 MCP 代理的编译 JavaScript 代码
• tsconfig.json - TypeScript 配置
• package.json - 包和依赖项的描述
• main.py用于文件检索的 Python HTTP 服务器
• whisper_server.py - 用于语音到文本转换的 Python HTTP 服务器
• README.md项目文档（本文件）