使用说明
- 项目简介
- Astonish 提供对 MCP 服务器的接入、管理以及与 LLM 客户端的标准化交互能力，支持将外部 MCP 服务器的工具、资源以及提示模板接入到代理工作流中。
- 主要功能点
- MCP 配置管理：支持从配置文件加载、保存与编辑 MCP 服务器清单及其连接参数。
- 传输适配：内置对 stdio 和 SSE 传输的支持，能够通过命令行或远程端口与 MCP 服务器进行通信。
- 工具集成：为 MCP 服务器创建并管理工具集，将服务器工具暴露给运行时的流任务，以便 LLM 调用外部功能。
- 工具与服务器的资源对接：通过 ADK 工具集框架，与 MCP 服务器进行交互，支持跨服务器的工具调用和结果聚合。
- 清理与生命周期管理：在流程结束或错误时释放传输资源，确保系统稳定性。
- 安装步骤
- 构建 Astonish：在项目根目录执行 go build（或按项目文档使用 make 构建），得到可执行二进制。
- MCP 配置编辑（必须步骤之一）：运行 astonish tools edit 打开 MCP 配置文件（mcp_config.json），在配置中添加你要对接的 MCP 服务器信息。
- MCP 服务器准备与启动：根据 MCP 服务器官方文档，启动你的 MCP 服务器，确保其可以通过传输模式（stdio 或 SSE）接入。
- 连接与验证：通过 Astonish CLI，确保已在 MCP 配置中注册的服务器可被发现并可通过工具集加载。
- 运行工作流：如需与 MCP 服务器工具协同，使用 astonish flows run <flow_name>，或在 Studio/CLI 中使用相应工具入口来执行。
- 服务器配置（用于 MCP 客户端以连接 Astonish 的 MCP 服务）
配置示例（为 MCP 服务器在配置文件中的注册信息，非代码块呈现）:
{
"mcpServers": {
"tavily-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"TAVILY_API_KEY": "<your-tavily-api-key>"
},
"transport": "stdio"
}
}
}
配置说明
- server name: tavily-mcp（示例名称，实际可自定义）
- command: 启动 MCP 服务器的可执行命令，例如 npx
- args: 启动命令的参数数组，例如 -y Tavily MCP 的版本
- env: 启动时的环境变量配置，可选项，如用于认证的 API Key
- transport: 传输模式，支持 stdio 或 SSE 注意：MCP 客户端本身不需要直接了解这些配置的细节，若要对接其他 MCP 服务器，请按实际服务器要求填写相应的命名、参数和环境变量。
- 基本使用方法
- 添加/管理 MCP 服务器：在 Astonish Studio 中配置 MCP 服务器，或通过 astonish tools edit 直接修改配置文件。
- 加载与执行工具：启动包含 MCP 工具集的流(flow)，Astonish 将从 MCP 服务器加载可用工具并在需要时调用。
- 运行时会话与资源：通过 MCP 服务器，LLM 客户端可以读取资源、调用工具、并获取模板化提示（Prompts）的渲染结果。
- 监控与清理：结束任务后，触发清理流程，释放传输资源，防止进程泄露。
信息
分类
AI与计算