Daofy for Delphi

一个为 AI 助手(如 Claude Desktop、CodeArts Agent 等)提供 Delphi 工程编译能力和知识库查询功能的 MCP Server。如果您觉得有用，请不要吝啬您的 Star! ⭐

Daofy（道飞）——为创意插上翅膀。

项目简介

Daofy for Delphi 是一个基于 Model Context Protocol (MCP) 的 MCP Server，它允许 AI 助手直接编译 Delphi 项目并查询 Delphi 知识库。通过这个工具,您可以在与 AI 助手的对话中直接编译 Delphi 工程、查询 API 文档、搜索代码示例,无需手动切换到 IDE 或命令行。

主要优势:

• 无缝集成到 AI 助手工作流中
• 自动检测和配置 Delphi 编译器
• 内置 Delphi 源码知识库,支持语义搜索
• 项目级知识库,自动追踪三方库和项目源码
• 通用文档知识库支持 Delphi CHM 帮助文档全文搜索
• 支持所有主流 AI 助手平台
• 完整的编译事件支持
• 详细的错误诊断和日志

功能特性

编译功能

• 工程整体编译: 支持编译完整的 Delphi 工程(.dproj/.dpr),生成可执行文件或动态链接库
• MSBuild 编译: 优先使用 MSBuild 编译,自动处理依赖关系和编译事件
• 单文件编译: 支持编译单个 Delphi 单元文件(.pas),进行语法检查
• 自动检测编译器: 自动从注册表检测已安装的 Delphi 编译器,无需手动配置
• 智能库路径解析: 自动分析项目依赖，智能选择需要的第三方库路径，避免命令行过长
• 编译事件支持: 支持 PreBuildEvent、PostBuildEvent、PreLinkEvent,包含完整的参数替换
• 命令行参数生成: 支持生成 Delphi 编译器命令行参数,便于调试和预览
• 编译器配置管理: 支持配置和管理多个 Delphi 编译器版本
• 环境检查: 提供编译器环境状态检查功能
• 丰富的编译选项: 支持条件编译符号、搜索路径、优化选项、调试信息、警告控制等

知识库功能

• Delphi 源码知识库: 内置 Delphi 官方源码知识库,支持类、函数搜索和语义搜索
• 项目知识库: 为每个项目构建独立知识库,自动追踪三方库和项目源码
• 三方库知识库: 从 .dproj 文件自动提取三方库路径并构建知识库
• 增量更新: 自动检测源码变动,增量更新项目知识库
• 示例知识库: 自动发现 Delphi 官方 Demo/Samples 和三方库 Demos/Tests，全文搜索示例代码
• 通用文档知识库: 支持 txt/md/html/docx/doc/pdf/epub/hlp/chm 和网页文档的扫描与搜索（基于 ZVec 向量存储 + FTS 全文索引）
  • 必需依赖: html2text, requests (已在 requirements.txt)
  • 可选依赖: python-docx (Word .docx 支持), antiword/catdoc (旧版 Word .doc 支持), PyMuPDF (PDF 支持，推荐) 或 pdfplumber (PDF 支持，备选), beautifulsoup4 (EPUB 支持)
• 智能去重: 基于完整路径去重，正确处理同名不同目录的文件

构建 Delphi 帮助文档知识库

用户首次使用或需要重建 Delphi API 文档时，调用 delphi_kb 工具构建文档知识库：

delphi_kb(
    action="build",
    kb_type="document",
    async_mode=true
)

说明：

• 不传 directory 时自动检测最新安装的 Delphi 帮助目录（通过注册表或默认路径）
• 也可手动指定：directory="C:\Program Files (x86)\Embarcadero\Studio\<版本>\Help\Doc"
  • 版本对照：37.0=Delphi 13, 23.0=Delphi 12, 22.0=Delphi 11, 21.0=Delphi 10.4, 20.0=Delphi 10.3
• extensions=[".chm"]：只扫描 CHM 文件，工具会自动解压并导入 HTML 文档
• async_mode=true：异步执行（耗时数分钟），提交后返回 task_id，通过 async_task(action=status, task_id=...) 轮询进度
• 需要系统安装 7-Zip（可放在 tools/7z/ 目录下免安装）

构建示例知识库

构建 Delphi 官方 Demos/Samples + 三方库 Demos/Tests 的全文搜索知识库：

delphi_kb(
    action="build",
    kb_type="example"
)

搜索示例代码：

delphi_kb(
    query="TThread.Queue",
    kb_type="example"
)

示例知识库仅全文搜索，不解析结构化符号（类/函数），适合快速查找示例用法。 使用 kb_type="all" 时默认不搜索示例知识库，需显式指定 kb_type="example"。

编码规范功能

• 编码规则查询: 获取 Delphi 源码编码规则,供 AI 助手用于代码审核和生成
• 默认规则支持: 内置默认编码规则文件,包含命名规则、格式化规则、修改规则和审核规则
• 自定义规则支持: 支持项目级别的自定义编码规则,优先于默认规则
• 规则优先级: 项目自定义规则 > 默认规则

MCP 工具列表

工具名称	功能描述
delphi_project	Delphi 项目全生命周期管理：编译(compile)/配置(info/set/create)/审计(audit/ast/runtime)
check_environment	诊断编译环境、检测编译器、安装 pasfmt
package	组件包管理：安装(action=install) / 列出已安装(action=list)
get_coding_rules	获取 Delphi 编码规范，支持按章节分段获取
delphi_kb	搜索代码/类/函数/文档/示例代码，查看统计或构建知识库
delphi_file	Delphi 文件专用操作：读/写(edits批量修改)/格式化/备份管理（编码检测+自动备份+DFM转换）
manage_component	DFM 组件增/删/改/生成 + PAS 自动同步
code_hosting	统一操作 Gitea/GitHub/GitLab/Gitee/GitCode 平台 + Git 本地操作
async_task	管理后台任务（构建知识库等）
tool_help	获取任意工具的完整帮助文档（按需，含参数说明/示例/触发词）
delphi_rtti	Delphi RTTI 桥接 — 通过 RTTI 发现和调用 Delphi 应用的运行时能力（三步法：discover/call/guide）
experience	经验记忆管理：保存/搜索/更新/合并/删除 AI 成功解决问题的做法；定期清理低价值条目（prune）；模型加载后重建缺失向量（rebuild_embedding）

系统要求

• Python 3.10-3.14
• Delphi 编译器(dcc32.exe 或 dcc64.exe)
• Windows 操作系统
• Git
• 7-Zip (用于解压 CHM 帮助文件,可选)

知识库存储位置

所有知识库数据存储在项目根目录的 data/ 文件夹下：

知识库类型	存储路径	说明
Delphi 源码知识库	data/delphi-knowledge-base/	Delphi 官方源码 (RTL

... View full README on GitHub