MCQuest MCP — 只读项目智能服务器

一个可复用、只读的 MCP 服务器，用于让 AI 编码代理以结构化方式访问软件项目的源代码和架构。

该服务器最初为 MCQuest 开发，并有意作为独立开发者工具维护在应用程序仓库之外。

它可以在不同项目中复用。

功能

当前版本（v0.2）提供 16 个只读工具，按类别组织：

项目结构

源代码分析

文档智能

跨证据与 Git

服务器不会修改目标项目。

Related MCP server: reflens

文档感知

文档工具为 AI 代理提供对项目 Markdown 文档（例如 docs/、memory-bank/）的只读访问，包括之前的审计和实施阶段。

• mcquest_list_docs — 列出项目相对路径下的 Markdown 文件。

• mcquest_read_doc — 带精确行号读取 Markdown 文件。

• mcquest_search_docs — 跨 Markdown 文档进行正则对比，返回文件路径、行号、匹配行以及周围上下文文本搜索。

• mcquest_phase_context — 两种模式：query 模式（自由文本："responsive overflow"、"Android"）和 phase 模式（结构化查找：phase="61"）。phase 模式按文档类型分组返回结果。

这些工具保留原始的 Markdown 证据和行引用。它们不会总结、重写或解读文档；它们返回原始证据，供 AI 代理自行推理。

这些工具通过保留原始文本和行引用，区分已记录的事实、已完成的工作、审计发现、建议、未解决的问题以及明确未验证/静态的发现。它们绝不会把未验证/静态的发现转换为已验证的事实。

安全

该 MCP 有意设计为只读。

它不提供：

• 文件编辑

• 文件创建

• 文件删除

• shell 执行

• 任意代码执行

• 包安装

• Git 变更

• 提交

• 推送

• 部署

服务器设计为提供证据，而 AI 编码代理执行推理。

推荐的 Cline 使用流程

1. mcquest_project_context — 先调用它了解项目整体方向

2. mcquest_phase_context(phase="N") — 了解特定阶段

3. mcquest_find_evidence(query="...") — 交叉搜索代码 + 文档

4. mcquest_read_file / mcquest_read_doc — 读取特定文件

5. mcquest_git_context — 在调查之前检查近期变更

6. mcquest_compare_phase(from_phase="61", to_phase="62") — 对比不同阶段

版本历史

• v0.2.0 — 新增 project_context、find_evidence、git_context、compare_phase，并改进了所有工具描述；为 phase_context 增加了 phase 参数，支持按文档类型分组的结构化查找。

• v0.1.0 — 初始版本，包含 12 个只读工具。

环境要求

• Windows、macOS 或 Linux

• Python 3.10+

• uv

• MCP Python SDK

• 仅在使用 MCP Inspector 时需要 Node.js

安装

将服务器克隆或放置到应用程序仓库之外的某个位置。

示例：

D:\DeveloperTools\mcquest-mcp