用途
该技能用于为 Glaido 桌面应用创建可导入的本地 MCP 服务器。最终产物是一个自包含文件夹,Glaido 可将其作为本地工具导入。文件夹中始终包含 mcp.json(Glaido 导入时读取的文件)、服务器代码、依赖以及环境配置。导入后,服务器提供的工具即可供 Glaido 的智能体使用。
Glaido 以本地进程方式通过 stdio 运行这些服务器:服务器由磁盘上的绝对路径启动,通过 stdin/stdout 进行 MCP 通信,密钥存放在代码旁边的本地 .env 中。用户无需了解 Glaido 内部机制,只需知道如何导入文件夹并设置密钥。
主要能力
- 判断应复用已有第三方 MCP 服务器,还是构建自定义服务器。
- 提供 hello-world 天气示例(使用免费 Open-Meteo API,无需 API 密钥、注册或 .env)。
- 支持多种语言:默认 Python + FastMCP(通过 uv 运行),也支持 TypeScript / Node,以及 Go、Rust、Java、C# 等其它语言。
- 提供脚手架模板、语言参考文档、运行时安装说明、现有服务器查找指南以及 Glaido 集成说明。
- 提供校验脚本,检查 mcp.json 缺失或格式错误、相对路径、命令不在 PATH、提交了密钥以及进程能否启动等常见导入阻塞问题。
使用方式
技能按步骤引导:
- 第 0 步:决定复用还是构建。连接 Notion、Slack、GitHub、Linear、Stripe、Google Drive、数据库等已知服务时,优先查找已有 MCP 服务器;围绕用户自有 API、脚本、业务逻辑或本地操作时则新建;若用户要求 hello-world 天气示例,则直接使用预置文件夹。
- 第 1A 步(复用路径):在 npm、GitHub、MCP 服务器注册表 / awesome-mcp 列表中搜索,向用户展示 1-3 个选项及其功能、认证需求和取舍,确认需要暴露哪些工具、权限范围等,再以本地 stdio 服务器方式接入。
- 第 1B 步(构建路径):明确要暴露的工具(如 create_invoice、search_contacts、restart_service)、每个工具的输入输出、通信对象、所需密钥,以及哪些工具是破坏性操作、哪些是只读操作。
- 第 2 步:选择语言与稳定位置。默认 Python + FastMCP,通过 uv 运行;默认位置为 ~/Glaido/glaido-mcp-servers/<server-name>。文件夹必须保持不动,移动后导入会失效。需先确认启动器已安装(uv、node、npx)。
- 第 3 步:从 assets/templates/ 复制并调整模板,生成包含 mcp.json、.env.example、.env、.gitignore、README.md 和服务器代码的文件夹。
- 第 4 步:实现服务器。要求包括:设置清晰的服务器级 instructions 字符串;按智能体可理解的方式命名和描述工具;参数有类型、返回结构化数据;标记只读与破坏性工具(readOnlyHint / destructiveHint);除 MCP 协议外不得向 stdout 写入任何内容,日志和调试输出应发往 stderr。
- 第 5 步:设置环境变量。默认由服务器从自身文件夹加载 .env;.env.example 存放占位值并提交,.env 存放真实值并被 .gitignore 排除;代码中按代码文件位置加载 .env。也可使用 mcp.json 的 env 块传递非密钥配置。
- 第 6 步:编写 mcp.json。文件必须命名为 mcp.json 并位于文件夹根目录,type 为 stdio,设置 instructions 显示描述,command 需在 PATH 中可解析,路径必须为绝对路径(用户通过 Tools 页面导入的文件夹可省略路径)。Windows 上 npx 和 npm 需用 cmd /c 包装。
- 第 7 步:交接前校验。运行 scripts/validate_glaido_mcp.py,并手动启动服务器确认能正常启动并暴露工具。
- 第 8 步:交接。最终消息必须以导入步骤结尾:填写 .env、打开 Glaido 应用点击侧边栏 Agent 下的 Tools、点击 Import、选择整个文件夹、打开服务器开关、在 Agent Mode 中试用。破坏性工具首次可能请求批准。
适用场景
- 为 Glaido 添加第三方服务集成(如 Notion、Slack、GitHub、Linear、Stripe、Google Drive、数据库等)。
- 围绕用户自有 API、脚本、业务逻辑或本地机器操作构建自定义工具。
- 运行 Glaido 的 hello-world 天气示例作为首个工具或参考代码。
限制
- 该技能面向 Glaido 桌面应用的本地 stdio 服务器,不涉及远程服务器类型。
- 服务器文件夹必须保持固定位置,移动后需重新导入。
- 除 MCP 协议外,任何 stdout 输出都会导致连接失败。
- 密钥不应提交到版本控制;.env 应被 .gitignore 排除。
- 关于具体收费、价格、平台支持范围等事实,资料中暂未提供。