License: MIT Python 3.10+ Delphi 2005-13

一个为 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 文件自动提取三方库路径并构建知识库
• 增量更新: 自动检测源码变动,增量更新项目知识库
• 通用文档知识库: 支持 txt/md/html/docx/doc/pdf/epub/hlp/chm 和网页文档的扫描与搜索
  • 必需依赖: beautifulsoup4, html2text, lxml, requests (已在 requirements.txt)
  • 可选依赖: python-docx (Word .docx 支持), antiword/catdoc (旧版 Word .doc 支持), PyMuPDF (PDF 支持,推荐) 或 pdfplumber (PDF 支持,备选)
• 智能去重: 基于完整路径去重,正确处理同名不同目录的文件

用户首次使用或需要重建 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 源码编码规则,供 AI 助手用于代码审核和生成
• 默认规则支持: 内置默认编码规则文件,包含命名规则、格式化规则、修改规则和审核规则
• 自定义规则支持: 支持项目级别的自定义编码规则,优先于默认规则
• 规则优先级: 项目自定义规则 > 默认规则

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

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

每个知识库目录包含:

• documents.sqlite / knowledge_base.sqlite / knowledge.sqlite - SQLite 数据库文件
• experiences.sqlite - 经验记忆数据库
• config.json - 知识库配置文件

每个知识库通过 config.json 文件进行配置,支持自定义数据库、源码路径、构建参数等。

配置文件在首次构建时自动生成,通常无需手动修改。

pip install daofy-for-delphi

安装完成后直接进入 → 配置 AI 助手 步骤即可。

国内用户可使用镜像源加速:

pip install daofy-for-delphi -i https://pypi.tuna.tsinghua.edu.cn/simple

请按以下步骤安装 Daofy:

[] 检查并安装 Git/Python 3.10-3.14/7-Zip

[] 安装 https://github.com/chinawsb/daofy.git(国内用户可用镜像: https://gitee.com/zuoyouruanjian/daofy.git)

[] 安装完成后验证结果并帮我配置当前客户端

git clone https://github.com/chinawsb/daofy.git
# 国内用户可用 Gitee 镜像加速:
# git clone https://gitee.com/zuoyouruanjian/daofy.git
cd daofy

python -m venv venv

Windows:

venv\Scripts\activate

Linux/macOS:

source venv/bin/activate

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

可选国内镜像源:

• 清华大学: https://pypi.tuna.tsinghua.edu.cn/simple
• 阿里云: https://mirrors.aliyun.com/pypi/simple/
• 中科大: https://pypi.mirrors.ustc.edu.cn/simple/

首次使用时,MCP Server 会自动从 Windows 注册表检测已安装的 Delphi 编译器,无需手动配置。

自动检测支持的 Delphi 版本:

• Delphi 13 Florence (37.0)
• Delphi 12 Athens (23.0)
• Delphi 11 Alexandria (22.0)
• Delphi 10.4 Sydney (21.0)
• Delphi 10.3 Rio (20.0)
• Delphi 10.2 Tokyo (19.0)
• Delphi 10.1 Berlin (18.0)
• Delphi 10 Seattle (17.0)
• Delphi XE8 (16.0)
• Delphi XE7 (15.0)
• Delphi XE6 (14.0)
• Delphi XE5 (12.0)
• Delphi XE4 (11.0)
• Delphi XE3 (10.0)
• Delphi XE2 (9.0)
• Delphi XE (8.0)
• Delphi 2010 (7.0)
• Delphi 2009 (6.0)
• Delphi 2007 (5.0)
• Delphi 2006 (4.0)
• Delphi 2005 (3.0)

如果需要手动配置或添加自定义编译器,可以直接编辑 config/compilers.json 文件,或使用 check_environment 工具的 detect action 重新检测。

如果通过 pip install daofy-for-delphi 安装,配置最简:

{
 "mcpServers": {
 "daofy": {
 "command": "daofy",
 "env": {
 "PYTHONUNBUFFERED": "1",
 "PYTHONIOENCODING": "utf-8",
 "PYTHONUTF8": "1"
 }
 }
 }
}

以下配置适用于通过 git clone 源码安装的用户,请将路径替换为实际安装路径。

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
 "mcpServers": {
 "daofy": {
 "command": "python",
 "args": ["C:\\path\\to\\daofy\\src\\server.py"],
 "env": {
 "PYTHONUNBUFFERED": "1",
 "PYTHONIOENCODING": "utf-8",
 "PYTHONUTF8": "1"
 }
 }
 }
}

Windows: C:\Users\<用户名>\.trae-cn\mcp_config.json

{
 "mcpServers": {
 "daofy": {
 "command": "F:\\ProPlus\\DelphiPlus\\Experts\\DelphiMCPServer\\delphi-complier-mcp-server\\venv\\Scripts\\python.exe",
 "args": [
 "F:\\ProPlus\\DelphiPlus\\Experts\\DelphiMCPServer\\delphi-complier-mcp-server\\src\\server.py"
 ],
 "env": {
 "PYTHONUNBUFFERED": "1",
 "PYTHONIOENCODING": "utf-8",
 "PYTHONUTF8": "1"
 }
 }
 }
}

注意: 请将路径修改为您的实际安装路径。

Windows: ~/.codeartsdoer/mcp/mcp_settings.json

{
 "mcpServers": {
 "daofy": {
 "command": "python",
 "args": ["src\\server.py"],
 "cwd": "C:\\path\\to\\daofy",
 "env": {
 "PYTHONUNBUFFERED": "1",
 "PYTHONIOENCODING": "utf-8",
 "PYTHONUTF8": "1"
 }
 }
 }
}

解决方案:

• 检查 config/compilers.json 文件中的编译器路径是否正确
• 使用 check_environment 工具 action=detect 重新检测编译器

解决方案:

• 检查 Python 环境是否正确配置
• 检查依赖是否已安装: pip install -r requirements.txt
• 检查 MCP 库版本: pip show mcp

解决方案:

• 确保已构建知识库: 使用 delphi_kb 工具的 action=build 构建
• 检查知识库目录是否存在

MIT License

Copyright (c) 2026 吉林省左右软件开发有限公司 Copyright (c) 2026 Equilibrium Software Development Co., Ltd, Jilin

详见 LICENSE 文件。

• delphi_file 全操作 RWLock 防并发文件损坏:read/write/batch_write/format/backup/uses 全部引入多读单写锁,并发写入返回明确错误引导合并 batch_write
• tools/7z/ 补齐 7z.dll,release 包开箱可用
• tool_docs.py 约束强化:batch_write 标注"⭐ 优先使用",新增并行写入禁令
• .gitignore 排除 dot-prefixed 目录,清理 AI 工作目录追踪

• delphi_file 新增 batch_write action:一次传入多个 edit,内部按 start_line 升序排列,以备份文件为参照系,内存中累积偏移量后一次性写出(配套 18 个测试用例)
• compilers.json 路径自愈:检测到不在 src/config/ 时自动回退到项目根 config/,避免 MCP 启动时因路径差异直接报错
• 18 处 except Exception: pass 添加 logger.debug 异常日志,便于调试时定位失败原因
• search_knowledge 重构:597→37 行,拆 16 个模块级子函数,行为完全等价
• 全量测试 727 passed

• delphi_file 部分写入行号修正:0-indexed 文档纠偏,写入后返回偏移量+后续行号调整公式
• delphi_file(action="uses") 同步返回偏移量信息
• AGENTS.md 新增部分写入规则章节:0-indexed 语义 + 连续编辑偏移算法
• 全量测试 684 passed, 6 skipped

• 新增 manage_component 工具:DFM 组件增/删/改/生成 + PAS 自动同步(替代原 generate_component_dfm)
• delphi_file 重命名+增强:DFM 二进制自动转换、备份管理、搜索定位(原名 file_tool,旧名仍兼容)
• get_coding_rules 增强:支持按章节分段获取,节省 token
• 新增 code_hosting 工具:统一 Gitea/GitHub/GitLab 操作
• 工作流从 6 步扩展为 7 步(1环境检查→2查KB→3写代码→4格式化→5编译→6审计→7清理)

完整版本历史详见 CHANGELOG.md

欢迎提交 Issue 和 Pull Request!

如果您觉得 Daofy for Delphi 对您有帮助,欢迎通过以下方式赞助支持我们。 您的支持让项目走得更远!❤️

账号: guansonghuan@sina.com(姓名:管耸寰,请标明QQ号)

支付宝收款码

账号: wangshengbo(发送红包或转账)

微信收款码

直接群支付,或给群主发红包

QQ收款码

QQ官方群: 250530692

如有问题或建议,请提交 Issue。