Bmorphism Krep MCP Server

🚀 Krep MCP 服務器

Krep MCP 服務器是一款基於模型上下文協議（Model Context Protocol）的高性能字符串搜索工具，它提供了統一接口，可在文件或字符串中進行高效搜索，極大地提升了搜索效率。

🚀 快速開始

Krep MCP 服務器的安裝非常簡單，按照以下步驟操作即可：

1. 克隆此倉庫
2. 進入 krep-mcp-server 目錄
3. 使用 Node.js 執行主程序

示例安裝命令

git clone https://github.com/your-username/krep-mcp-server.git
cd krep-mcp-server
node src/index.js

✨ 主要特性

Krep MCP 服務器具備以下主要功能：

1. 統一接口：通過單一函數就能實現文件搜索、字符串搜索和計數功能，操作簡便。
2. 高性能算法：
   • 會基於模式長度自動選擇最優算法（KMP、Boyer - Moore - Horspool、Rabin - Karp），確保搜索效率。
   • 支持 SIMD 指令加速，進一步提升性能。
3. 多線程支持：能自動利用所有 CPU 核心，顯著提升搜索效率。

📦 安裝指南

Krep MCP 服務器的安裝步驟如下：

1. 克隆此倉庫。
2. 進入 krep-mcp-server 目錄。
3. 使用 Node.js 執行主程序。

示例安裝命令

git clone https://github.com/your-username/krep-mcp-server.git
cd krep-mcp-server
node src/index.js

💻 使用示例

基礎用法

請求格式

<use_mcp_tool>
<server_name>krep</server_name>
<tool_name>krep</tool_name>
<arguments>
{
  "pattern": "search pattern",
  "target": "file path or string to search",
  "mode": "file|string|count",
  "caseSensitive": true|false,
  "threads": null // 自動檢測 CPU 核心數，默認為自動模式
}
</arguments>
</use_mcp_tool>

參數說明

• pattern（必填）：搜索的模式字符串。
• target（必填）：文件路徑或待搜索的字符串。
• mode（可選）：
  • file（默認）：在文件中搜索。
  • string：在字符串中搜索。
  • count：僅計數出現次數。
• caseSensitive（可選）：是否區分大小寫，默認為 true。
• threads（可選）：使用的線程數，默認自動檢測 CPU 核心數。

使用示例

具體示例請參見 examples.md。

📚 詳細文檔

性能優化

Krep MCP 服務器在設計上十分注重性能，具體優化措施如下：

1. 算法選擇：
   • 對於極短模式（<3 字符），使用 KMP 算法。
   • 中等長度模式（3 - 16 字符），採用 Boyer - Moore - Horspool 算法。
   • 長模式（>16 字符），則使用 Rabin - Karp 算法。
2. 硬件加速：利用 SIMD 指令提升性能。
3. 動態多線程：自動利用所有可用 CPU 核心。

Cline VSCode 插件集成

Krep MCP 服務器可與 Cline VSCode 插件無縫集成，讓您能直接在 VSCode 環境中使用高性能搜索功能。

安裝步驟

# 安裝插件
./install-cline-integration.sh

# 測試插件前請先安裝
./run-cline-test.sh

# 卸載插件時運行
./uninstall-cline-integration.sh

Cline 中的使用

集成完成後，您可在 Cline 對話中直接使用 krep：

/krep krep pattern="function" target="/path/to/search" mode="file"

更多安裝和使用細節請參考：

• CLINE_SETUP.md - 安裝指南
• CLINE_README.md - 使用說明

集成到 Infinity Topos 環境

Krep MCP 服務器為 Infinity Topos 環境設計了無縫集成方案：

• Babashka 集成：用於處理搜索結果。
• Say 集成：通過 Say MCP 服務器發聲播報搜索結果。
• Coin - Flip 集成：利用隨機化確定搜索策略。

開發環境

環境變量

• CLAUDE_MCP：設為 "true" 啟用 MCP 模式。
• KREP_PATH：指定 krep 可執行文件路徑。
• DEBUG：設為 "true" 以啟用詳細日誌輸出。
• KREP_TEST_MODE：設為 "true" 進入測試模式，使用模擬響應。
• KREP_SKIP_CHECK：設為 "true" 跳過檢查 krep 是否存在。

HTTP 服務器模式

非 MCP 模式下，服務器啟動以下端點：

1. /api/search：
   • POST 請求體應包含搜索參數。

📄 許可證

本項目遵循 MIT License。

貢獻者

感謝所有貢獻者！

鏈接

• GitHub 倉庫
• 問題報告