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 仓库
• 问题报告