MCP Server (language Server Protocol)

🚀 MCP 服務器（語言服務協議）

MCP 服務器是一個基於 TypeScript 的語言服務協議實現，主要用於代碼引用搜索，支持多種搜索策略，能幫助開發者高效地查找代碼引用。

🚀 快速開始

MCP 服務器可助力開發者進行代碼引用搜索。在使用前，需完成相關的安裝與配置。

✨ 主要特性

• 🔍 藉助 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

其他問題

如需更多幫助，請查看項目文檔或聯繫維護人員。