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. 克隆此仓库：

git clone https://github.com/your-username/krep-mcp-server.git

2. 进入 krep-mcp-server 目录：

cd krep-mcp-server

3. 使用 Node.js 执行主程序：

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. 算法选择：
   • KMP 算法用于极短模式（<3 字符）。
   • Boyer - Moore - Horspool 算法适用于中等长度模式（3 - 16 字符）。
   • Rabin - Karp 算法处理长模式（>16 字符）。
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_SETUP.md) - 安装指南
- [CLINE_README.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 仓库
• 问题报告