使用说明（Markdown 格式）

项目简介
- Codesearch 的 MCP 服务器实现，作为后端服务端，面向 MCP 客户端提供资源管理、工具执行、以及 Prompt 渲染能力，支撑 LLM 在代码世界中的上下文提供和外部功能调用。
主要功能点
- MCP 请求/响应处理：接收来自 MCP 客户端的 JSON-RPC 请求，返回相应的 JSON-RPC 响应或错误信息。 -工具注册与执行：在 MCP 服务器中注册可调用的 Tools（如 agentic_code_search），并在客户端请求时执行。
- 资源与 Prompts 渲染：托管所需的资源、Prompt 模板，支持客户端定制化交互流程。会话管理与能力声明：实现对会话、能力的声明与管理，便于客户端了解服务器能力边界。传输协议：当前实现通过 stdio 传输通道进行通信，便于嵌入到命令行和本地进程间通信，后续可扩展到 SSE/WebSocket 等传输方式。
安装步骤
1. 克隆仓库并进入 MCP 服务器相关目录。
2. 构建为可执行程序（Release 版本优先）：
  - 在包含 MCP 服务器代码的工作区中执行构建命令。
3. 运行前置依赖准备：
  - 确保代码搜索后端的其他组件就绪（如 embedding、数据库、搜索 API 实现等），以便 MCP 服务器能正常创建并调用底层的 SearchApi。
4. 启动 MCP 服务器：
  - 使用提供的启动入口，通过标准输入传输（stdio）启动。
  - 如需连接到具体的搜索后端，请确保后端服务已就绪并能够被 MCP 服务器的实现调用。
服务器配置（MCP 客户端需要）说明：MCP 客户端需要提供一个 JSON 配置，用来描述如何启动 MCP 服务器（server name、command、args），以便建立与 MCP 服务器的连接。以下描述为示例级别、帮助理解的配置要点，不作为代码实现。

示例配置要点（JSON 格式描述，不包含代码）：
- server_name: codesearch-mcp
- command: 指向可执行的 MCP 服务器二进制的路径，例如 "/usr/local/bin/codesearch-mcp-server"。
- args: 启动参数数组，若服务器需要额外配置文件，可通过如 ["--config", "/etc/codesearch/mcp_config.json"] 形式传入。
- 备注: 客户端在连接前需要确保服务器二进制可执行且所依赖的后端服务已经启动并可访问。
基本使用方法
- 启动阶段
  - 在合适的运行环境下，通过配置好的命令启动 MCP 服务器（二进制可执行文件）。
  - 服务器上线后，客户端通过 MCP 的 JSON-RPC 规范向服务器发送请求，例如读取资源、调用工具、获取 Prompt 等。
- 运行阶段
  - 客户端发送请求后，服务器返回标准的 JSON-RPC 响应，或在错误时返回 Tool Error 信息。
- 典型场景
  - 客户端请求 agentic_code_search 工具执行搜索，服务器将通过内部的 AgenticSearchOrchestrator 与后端服务协同工作，最后将结果以 MCP 可解析的格式返回。
备注
- 该 MCP 服务器实现的核心能力在于对 Agentic Search 流程的封装与暴露，实际对接的底层后端（如 Embedding、Reranking、Graph 查询等）由 Codesearch 的其他 crates 提供实现。

关键词

信息