Lian-MCP-LLM 代理系统的设计理念

作者 - Lian - 2025

---

初步构想

使用多个专家（多个LLM）解决问题（将LLMs封装成类，将每个LLM会话管理为一个实例）

使用 pydantic 模型 来管理专家团队，以及各个专家的参数

实现的核心功能

1. 使用LLM完成代码创建和修改任务（用于实践）

   • 关键点：使用任务流程专家来管理流程，代码专家生成代码，并调用MCP执行文件写入

2. [已废弃：这不是我所爱] 使用LLM自动组织表单（在导师指导下）

   • 关键点：使用任务流程专家来管理流程，读取专家分析文件内容，组织专家操作并移动文件

3. [已废弃：这不是我所爱] LLM自动渗透测试（在导师指导下）

   • 关键点：使用任务流程专家来管理流程，调用渗透专家工具并分析结果

4. 访问 YosaCat

---

项目进度

|数据库 - 已完成---

使用 PostgreSQL 基于 Pydantic 的ORM封装已完成

SQL模块 - 已完成---

一个完全自开发的轻量级ORM系统，目前支持：

• 基于Pydantic的模型定义和数据验证
• 完整的CRUD操作（创建、读取、更新、删除）
• Python侧外键关系抽象（一对一、一对多、多对一）
• 关系查询（批量加载关联对象以避免N+1问题）
• JOIN多表联合查询（内连接、左连接、右连接、全连接）
• 连接池管理和自动重连机制
• SQL文件解析，自动提取表结构元数据
• 枚举类型支持，JSON/JSONB字段处理
• 级联删除，事务支持

测试套件

连接测试：uv run python ./tests/sql_connect.test.py 关系功能测试：uv run python ./tests/test_relations.py 完整功能测试（学习文档）：uv run python ./tests/test_sql_complete.py

文档

SQL模块使用文档 （点击跳转）

数据模型系统文档 （点击跳转）

仓库层API文档 （点击跳转）

配置说明 （点击跳转）

| mcp 包 -- 待定---

完成了基本任务的MCP服务器和LLM客户端功能（纯屎山）

测试 Server：uv run python ./main.py server

测试 Client：uv run python ./main.py client

目前，MCP库集成了mcp_userver和llm_client的功能，未来需要分离：

• MCP：负责实现MCP工具，元数据提取，以及与本地知识库的联动

• LLM：负责LLM-Chat的创建和生命周期管理

|配置包 - 已完成---

用于配置加载，已经完成

测试：uv run python ./tests/config.test.py

文档 用户指南.md （点击跳转）

|实用工具包

当前实现的包

打印器 -- 已完成---

提供了一种彩色打印方法

输出 -- 已完成---

基于 Printer 完全重构，目前支持：

• 基于ANSI的文本效果、文本颜色和背景色显示
• 支持256色，RGB 24位颜色
• 支持将ANSI代码转换为RGB真彩色显示

效果预览：uv run python ./tests/utils_Loutput/Loutput.test.py 比较终端颜色与真彩色：uv run python ./tests/utils_Loutput/color_comparison.py 测试RGBColor：uv run python .tests/utils_Loutput/rgb_quick.py

文档

输出使用文档 （点击跳转）

终端颜色显示指南 （点击跳转）

RGBColor 使用指南 （点击跳转）

---

🎓 学术使用声明

本项目是2025届的毕业项目

⚠️ 重要通知：

• 保护期：2025年11月10日-2026年1月19日
• 在此期间，同校同学禁止使用本项目进行毕业设计
• 禁止任何形式的学术作业提交
• 请参阅LICENSE文档以获取详细条款和条件

---

开发之外

记得花些时间阅读 任务分配 和 毕业设计报告模板 再次提醒 阅读论文！