Code Search MCP

🚀 代码搜索MCP服务器

这是一款面向AI智能体的高性能、批量处理的MCP（模型上下文协议）代码理解工具包，特别针对Java进行了优化。它旨在解决AI智能体在大型代码库中“迷失方向”或缺乏精确上下文的难题，专注于深度解析、并行批量处理和全景上下文，能够高效探索大型代码库，显著减少令牌使用量，同时提升逻辑理解能力。

🚀 快速开始

本工具包专为解决AI智能体在大型代码库中的难题而设计，通过深度解析、并行批量处理和全景上下文等技术，帮助AI智能体更高效地理解代码。

✨ 主要特性

使用场景

• 全景上下文：一次调用即可读取多个文件，并自动扩展依赖上下文。
• 结构映射：借助对Java注解的深度理解，快速构建项目大纲。
• 精准定位：精准定位类、方法和定义，并批量返回结果。

核心工具

设计要点

• 标准输入输出传输：通过标准输入输出使用JSON - RPC 2.0协议。
• 确定性协议：仅使用绝对路径，不支持路径通配符。
• Java大纲增强：将注解回溯合并到签名中。

Java Spring深度适配

本工具不仅仅是文本搜索，还能理解业务逻辑：

• 分层感知排序：智能排序（控制器 → 服务 → 实现 → 消息队列 → 仓库），让AI能立即理解业务流程。
• 深度注解感知：AI不仅能看到签名，还能看到合并后的注解（如@Transactional、@PreAuthorize），从而理解业务语义。
• 智能依赖注入解析：自动识别注入字段（依赖项），无需AI猜测userService的来源。
• 项目结构支持：全面支持src/main/java和多模块Maven/Gradle项目。

📦 安装指南

环境要求

• Node.js v18.0.0或更高版本

安装与构建

npm install
npm run build

💻 使用示例

集成示例

"mcpServers": {
  "code-search": {
    "command": "node",
    "args": ["{file}/code-search/index.js"]
  }
}

📚 详细文档

使用提示

• 优先选择：若需要一次性获取完整上下文，建议使用view_files_full_context。
• 路径要求：为确保稳定性和可重复性，请使用绝对路径。
• 复杂查询：复杂查询应拆分为精确调用。

📄 许可证

本项目采用MIT许可证进行开源。你可以在许可证条款的规定下使用、修改和分发该项目。