梅科尔工作室Cangjie Magic探索：菌趣百科原创

梅科尔工作室HOS

发布于 2025-5-20 19:20

浏览

0收藏

作者：罗俊杰
团队：梅科尔工作室

一、项目背景

每一块发霉的面包、每一滴池塘水，都是藏着无数微生物的“迷你宇宙”！菌落就像这些小生命建造的“外星城市”——有的像闪亮的果冻水晶宫，有的像毛茸茸的棉花糖城堡，甚至还有会发光的“赛博朋克”部落。那么如何查看这些“微生物星球”的密码？
梅科尔工作室Cangjie Magic探索：菌趣百科-鸿蒙开发者社区

传统方法就像用老式显微镜玩《星际穿越》——培养皿里等三天才长出几个菌斑，新手分分钟把大肠杆菌认成“外星异形”。而高科技检测设备又像需要密码锁的宇宙飞船，只有穿白大褂的“星际舰长”才能操作。

于是，我们决定造一个微生物版“塞尔达传说”——让每个人都能拿着“知识探测器”，在培养皿里玩解谜冒险！无论你是好奇的学生、厨房探险家，还是想守护食品安全的“地球卫士”，都能用趣味问答揭开菌落的神秘面纱，把实验室变成探索生命奥秘的游乐场！

二、项目简介

我们打造的菌趣百科小助手是基于Cangjie Magic智能体引擎与MCP协议开发的菌落知识互动平台，将专业微生物检测转化为趣味科学探索。系统通过searchMycologyInfo和matchMycologyType两大核心工具函数，实现“菌落特征→菌种身份”的实时推理，真正让微生物学从实验室走向厨房、课堂和生产线，成为人人可玩的“科学冒险”把晦涩的微生物术语变成萌萌的菌菌小剧场——比如用“果冻水晶宫”描述酵母菌群落，用“荧光触手怪”比喻发光杆菌。

流程图：

梅科尔工作室Cangjie Magic探索：菌趣百科-鸿蒙开发者社区

三、项目运行

工具说明

①Cangjie Magic

Cangjie Magic 智能体规划引擎架构，实现从声明式智能体建模到任务执行的闭环。

核心组件功能强大 其核心组件 AgentDSL是专门用于定义和管理Agent的语言。开发者能借助结构化系统提示词、工具及协作策略增强Agent功能与灵活性，实现全生命周期管理。该组件是仓颉语言的嵌入式DSL，最终会转换为普通仓颉代码由编译器编译。
梅科尔工作室Cangjie Magic探索：菌趣百科-鸿蒙开发者社区

②MCP协议：

MCP （Model Context Protocol，模型上下文协议）定义了应用程序和 AI 模型之间交换上下文信息的方式。这使得开发者能够以一致的方式将各种数据源、工具和功能连接到 AI 模型（一个中间协议层），就像 USB-C 让不同设备能够通过相同的接口连接一样。MCP 的目标是创建一个通用标准，使 AI 应用程序的开发和集成变得更加简单和统一。
梅科尔工作室Cangjie Magic探索：菌趣百科-鸿蒙开发者社区

项目构建

①服务端构建

MCP-service智能助手接收到用户输入后，会根据问题的类型和内容，调用相应的工具函数进行处理。

实现功能：

即时检索与详尽阐释：为用户提供全面而深入的菌落知识，帮助用户构建起对菌落的全面理解框架。
精准匹配探索：用户仅需描述菌落的某些特征或功能，系统便能智能调用数据库，迅速筛选出与之匹配的菌落种类，并提供专业建议。
互动强化学习：通过持续的用户需求输入，支持动态的、交互式的学习模式，帮助用户深化对菌落基础知识的理解与记忆，实现知识与经验的双重积累。

工具函数执行：

工具函数：
- searchMycologyInfo：用于检索与用户输入关键词相关的菌落知识点。
- matchMycologyType：根据用户描述的菌落特征或功能，匹配相应的菌落种类。
智能助手类：
- MycologyAssistant：定义了智能助手类，使用了两个工具函数，描述了其功能，包括即时检索、精准匹配以及互动强化学习等。

package xxxx//工程名
import magic.dsl.*
import magic.prelude.*
import magic.config.Config
import magic.mcp.StdioMCPServer
import log.LogLevel//导入需要的工具包


import log.LogLevel

@tool[description: "检索菌落相关知识点"]
func searchMycologyInfo(keyword: String): String {
    // 这里可以实现具体的检索逻辑，返回与关键词相关的菌落知识点
    return "检索到的关于菌落的知识点：$keyword"
}

@tool[description: "匹配菌落种类"]
func matchMycologyType(features: String): String {
    // 这里可以实现具体的匹配逻辑，根据特征筛选出匹配的菌落种类
    return "匹配到的菌落种类：$features"
}

@agent[
    model: "xxx调用智能体的模型配置",
    description: "菌趣百科智能助手",
    tools: [searchMycologyInfo, matchMycologyType]
]
class MycologyAssistant {
    @prompt(
        "一些适当的提示词"
    )
}

梅科尔工作室Cangjie Magic探索：菌趣百科-鸿蒙开发者社区

主函数启动：函数初始化配置、创建智能助手实例并启动服务端

main() {
    // 设置环境变量，配置 SiliconFlow API 的密钥
    Config.env["SILICONFLOW_API_KEY"] = "密匙"
    
    // 设置日志级别为 INFO
    Config.logLevel = LogLevel.INFO
    
    // 设置日志文件路径
    Config.logFile = "./logs/mcp-server.log"
    
    // 创建菌趣百科智能助手的实例
    let agent = MycologyAssistant()
    
    // 启动服务端，将智能助手实例注册到服务端
    StdioMCPServer.startWith([agent])
}

梅科尔工作室Cangjie Magic探索：菌趣百科-鸿蒙开发者社区

②客户端调用

菌趣百科智能助手客户端是用户与智能问答系统交互的前端工具。它通过简洁的代码和高效的技术架构，实现了用户问题的即时处理和知识的精准推送。以下是客户端的整体逻辑、构建原理及技术细节的详细梳理。
实现功能： 环境配置与初始化、智能助手实例化、实时交互与反馈、MCP 命令支持

功能实现：

package XXX // 定义包名，用于组织代码结构

import magic.dsl.*           // 导入 magic 框架的 DSL（领域特定语言）模块
import magic.prelude.*       // 导入 magic 框架的基础模块
import magic.config.Config   // 导入配置模块，用于设置系统参数

import log.LogLevel          // 导入日志级别模块，用于控制日志输出

// 定义智能助手类 HomeworkAssistant
@agent[
    model: "XXX",  // 配置使用的模型
    mcp: [  // 配置与服务端的通信命令
        { command: "cjpm", args: ["run", "--skip-build", "--name", "服务端名称"] }
    ]
]
class HomeworkAssistant {
    @prompt(  // 定义智能助手的提示信息，帮助用户了解助手的功能
        "你能实时查找菌落相关知识的问答百科小助手，助力菌落知识科普，降低专业性要求，让更多的人参与菌落相关领域研究。"
    )
}

// 主函数，程序的入口点
main() {
    // 配置环境变量，设置访问外部模型所需的 API 密钥
    Config.env["SILICONFLOW_API_KEY"] = "sk-密匙"
    
    // 设置日志级别为 INFO，记录关键信息
    Config.logLevel = LogLevel.INFO
    
    // 设置日志文件路径，便于后续查看和分析日志
    Config.logFile = "./logs/mcp-client.log"

    // 创建智能助手的实例
    let agent = HomeworkAssistant()
    
    // 调用智能助手的 chat 方法，发送用户问题到服务端
    // 这里以“金黄色葡萄球菌是什么”为例，用户可以替换为其他问题
    let result = agent.chat("金黄色葡萄球菌是什么")
    
    // 将服务端返回的结果打印到控制台，展示给用户
    println(result)
}