MCP 服务器（语言服务协议）

一个基于 TypeScript 的语言服务协议实现，用于代码引用搜索，支持多种搜索策略。

特性

• 🔍 使用 ripgrep 实现快速代码引用搜索
• 🌐 提供网络界面以方便搜索
• 💻 终端界面支持命令行使用
• 📊 按文件类型分组显示结果
• 🔄 多种备用搜索机制
• 🔥 开发时的热重载支持

先决条件

在开始之前，请确保安装以下内容：

• Node.js（v14 或更高版本）
• npm（随 Node.js 一起提供）
• Homebrew（仅限 macOS 用户）
• ripgrep（推荐用于更快搜索）

安装

1. 克隆仓库

git clone <your-repository-url>
cd <repository-name>/src/mcp-server/v1

2. 安装 Homebrew（仅限 macOS）

# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 将 Homebrew 添加到 PATH（请按照安装后显示的说明操作）
# 通常这些命令：
(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# 重启终端或运行
source ~/.zprofile

3. 安装 ripgrep

# macOS（使用 Homebrew）
brew install ripgrep

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install ripgrep

# Fedora
sudo dnf install ripgrep

# Windows（使用 Chocolatey）
choco install ripgrep

4. 安装依赖项

npm install

使用说明

构建项目

npm run build

启动服务器

生产模式

npm run start

开发模式（带热重载）

npm run dev

访问界面

1. 网络界面

   • 在浏览器中打开：http://localhost:3000
   • 输入搜索词和目录
   • 查看按文件类型分组的结果

2. 终端界面

   • 终端界面随服务器自动启动
   • 按照提示输入搜索词
   • 结果将在终端中显示

搜索策略

服务器按照以下顺序使用多种搜索策略：

1. ripgrep（最快）

   • 使用正则表达式实现精确和部分匹配
   • 忽略常见目录（node_modules、.git 等）
   • 提供行号和上下文

2. grep（备用）

   • 如果 ripgrep 不可用时使用
   • 功能相似但速度较慢

3. Node.js（最后的备用方案）

   • 纯 JavaScript 实现
   • 在 ripgrep 和 grep 都不可用时使用

配置

环境要求

• 服务器会自动检查所需的软件
• 提供缺失软件的安装说明
• 验证正确的当前目录

TypeScript 配置

• 目标：ES2020
• 模块：ESNext
• 出口：true
• 格式：UTF-8
• 严格模式：启用
• 允许未声明的变量：禁用

故障排除

网络问题

如果无法访问网络，请检查防火墙设置或代理配置。

依赖项问题

如果 npm 安装失败，请尝试使用管理员权限运行：

npm install --force

其他问题

如需更多帮助，请查看项目文档或联系维护人员。