金大哥 - code-search-mcp MCP 详情

article

README

🚀 代码搜索MCP服务器

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

🚀 快速开始

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

✨ 主要特性

使用场景

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

核心工具

| 工具 | 功能 | 说明 | | --- | --- | --- | | view_files_full_context | 全景上下文 | 批量读取文件，同时扩展依赖和模型字段 | | view_files_outlines | 结构大纲 | 批量提取大纲，并理解Java注解 | | view_code_items | 精准定位 | 批量定位类、方法和定义 |

设计要点

标准输入输出传输：通过标准输入输出使用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许可证进行开源。你可以在许可证条款的规定下使用、修改和分发该项目。

code-search-mcp