企业官网建设流程全解析

• AI 应用
• 人工智能
• 大模型
• AI Agent
• 桌面应用
• 语音
• MCP Clients
• Agent 编排

Yoji是一款有情绪的 AI 桌面伴侣，而它的"无限扩展"能力来自 MCP（Model Context Protocol）生态。本文介绍最简单的 12306 查票 MCP 接入方法——10 秒给 AI 加上火车票查询工具；还会讲清楚 Yoji 如何让你只说一句话，AI 就自己找、自己测、自己装新工具，你只需要点一下"同意"。

什么是 MCP：给桌面 AI 装上"无限手脚"

MCP 是开放的行业标准协议，不是某个产品的私有插件系统。任何符合 MCP 规范的服务都能接入 Yoji，能力边界由你决定：

• 想查火车票？装一个12306 MCP服务器，10 秒搞定
• 想搜菜谱？接一个菜谱 MCP，今晚吃什么不用纠结
• 想看网页？Fetch MCP 直接抓取转 Markdown

Yoji 底层通过@langchain/mcp-adapters的MultiServerMCPClient实现动态工具发现：每接入一个 MCP 服务器，它暴露的所有工具会自动注册进 Agent 工具列表，且工具名带服务器前缀，多个服务互不冲突。核心实现见 src/main/agent/mcp/index.ts。

手动接入 MCP：10 秒装好 12306 查票工具

手动接入全程只需要 4 步，界面在左侧导航栏的「MCP」页面：

1. 点击「新增」卡片，填写名称（如"12306定票工具集合"）和key（唯一标识，如12306-mcp）
2. 选择传输协议并填对应信息：远程服务填 URL，本地服务填启动命令
3. 写一句功能简介，方便 AI 判断什么时候用它
4. 点保存——自动测试连接，成功后新工具下一轮对话即可用

三种传输协议怎么选，看这张速查表：

页面逻辑在 src/renderer/src/pages/mcp-manage/McpManage.tsx，保存时会自动触发一次连接测试（15 秒超时），测试代码见 src/main/agent/mcp/index.ts。

更酷的事：对 AI 说一句"帮我装个天气工具"

Yoji 内置了一个MCP 管理器子 Agent，它手握三个工具：

• list_mcp_servers：列出已安装的 MCP 服务器和工具数量
• install_mcp_server：安装或修改 MCP 服务器（先测连接，可用才保存）
• uninstall_mcp_server：卸载不再需要的服务器

它的系统提示词明确规定了工作流："用户说'帮我装个天气 MCP' → 调用install_mcp_server安装"，源码见 src/main/agent/children-agent/agent-default/index.ts。安装工具的参数设计也很"AI 友好"——连npx找不到时怎么填 PATH 都在描述里写清楚了，详见 src/main/agent/tools/mcp-manage.ts。

🔒 安全兜底：AI 装工具必须你点头

自动装工具听起来很爽，但 Yoji 给这道流程加了人工审批：install_mcp_server和uninstall_mcp_server都被配置为中断审批（interrupt），AI 每次安装/卸载前都会弹窗等你选择"同意"或"拒绝"，配置见 src/main/agent/create-agent.ts。也就是说：找、测是 AI 干的活，决定权始终在你手里。

装完不满意？在 MCP 页面把「启用」开关关掉即可，Agent 配置一变会自动重建，开关逻辑在 src/renderer/src/pages/mcp-manage/McpManage.tsx。

为什么装再多工具也不会变乱？

很多 AI 应用工具一多就开始"犯迷糊"。Yoji 的解法是子 Agent 架构：

• 主 Agent 只负责对话和调度，MCP 工具默认只暴露给子 Agent，不污染主对话的工具列表（MCP 卡片上的「主Agent启用」开关就是干这个的）
• 还可以在「工坊」页面自建子 Agent，为它绑定专属 MCP 工具集——上图就是"浏览器控制器"只绑定 Chrome DevTools MCP 的例子
• 每次安装/启用/停用 MCP，都会触发 Agent 版本变更并自动重建，下一轮对话新工具立即可用，全程不用重启应用

这正是 README 里说的：子 Agent 架构确保装再多工具也不影响对话质量。

常见问题速查

快速上手

git clone https://gitcode.com/gh_mirrors/yo/yoji cd yoji pnpm install pnpm dev

启动后先在「模型」页面填入 API Key，再到「MCP」页面接入你的第一个 12306 查票工具——10 秒后，你的 AI 伴侣就能帮你查票了。

相关源码与文档：

• MCP 客户端与连接测试：src/main/agent/mcp/index.ts
• AI 自主装/卸 MCP 工具：src/main/agent/tools/mcp-manage.ts
• 内置 MCP 管理器子 Agent：src/main/agent/children-agent/agent-default/index.ts
• MCP 审批中断配置：src/main/agent/create-agent.ts
• MCP 管理页面：src/renderer/src/pages/mcp-manage/McpManage.tsx
• 项目说明与架构图：README.md

• AI 应用
• 人工智能
• 大模型
• AI Agent
• 桌面应用
• 语音
• MCP Clients
• Agent 编排