★ FEATURED ARTICLE 【免费下载链接】AQBot☁️ 轻量级高性能跨平台AI对话 AI Agent AI网关桌面客户端 | Lightweight, high-performance cross-platform AI dialogue AI Agent AI gateway desktop client项目地址https://gitcode.com/gh_mirrors/aq/AQBot点击查看免费下载AQBot 是一款跨平台 AI 对话 AI Agent AI 网关桌面客户端内置 MCPModel Context Protocol客户端支持通过stdio、SSE、StreamableHTTP三种传输方式连接工具服务器让 AI 在对话中直接调用网页抓取、文件读写、数据库查询等外部工具。本文将带你从零开始完成 MCP 配置并附常用示例与排错技巧。什么是 MCP 服务器MCP 是一种开放协议让 AI 模型与外部工具和数据源交互。通过 MCP模型可以在对话中调用网页抓取、文件系统、数据库查询等工具大幅扩展 AI 的实际能力。AQBot 在客户端内置了完整的 MCP 支持类型定义见 src/types/mcp.ts三种传输协议— stdio、SSE、StreamableHTTP 全覆盖内置工具服务器— 开箱即用的网页抓取与文件搜索无需安装权限策略— 每次询问 / 允许安全操作 / 允许全部灵活控制风险超时控制— 可分别配置发现超时与执行超时避免卡死三种传输协议怎么选协议连接方式适用场景关键参数stdio本地子进程用npx、uvx等命令启动的本地工具命令 参数SSEServer-Sent Events远程托管的 MCP 服务器端点 URLStreamableHTTPHTTP 流式传输远程 HTTP 服务器支持双向流端点 URL 简单判断工具装在你电脑上 → 用stdio工具部署在远端服务器 → 用SSE或StreamableHTTP。快速入门进入 MCP 服务器设置操作路径设置 → MCP 服务器。左侧是服务器列表分为内置工具和自定义两组右侧是当前服务器的详细配置面板界面实现见 src/components/settings/McpServerSettings.tsx。列表项旁的传输标签一目了然STDIO蓝色终端图标— 本地子进程SSE橙色广播图标— 远程 SSEHTTP绿色地球图标— StreamableHTTP每个服务器右侧有一个开关可随时启用或停用不需要删除配置。第一步配置 stdio 本地服务器大多数 MCP 服务器以 stdio 模式运行AQBot 在本地启动一个进程通过标准输入/输出与它通信。表单创建步骤在 MCP 服务器页面点击添加 MCP 服务器在弹窗中选择表单创建标签页填写名称取个易识别的名字传输协议选择Stdio填写启动命令与参数命令如npx、uvx、python参数空格分隔如-y modelcontextprotocol/server-name可选在环境变量区按KEYVALUE每行一条填写例如API_KEYxxx保存后 AQBot 自动连接并拉取可用工具列表典型配置示例网页抓取工具用uvx启动命令: uvx 参数: mcp-server-fetch文件系统服务器用npx启动指定可访问目录命令: npx 参数: -y modelcontextprotocol/server-filesystem /Users/你的用户名/Documents⚠️安全提示文件系统服务器会授予 AI 对指定目录的读写权限请只暴露必要的目录避免暴露根目录或敏感目录。第二步连接 SSE 远程服务器如果 MCP 服务器部署在远程比如公司内网托管选择SSE传输传输协议选择SSE端点地址填写服务器 URL如https://mcp.example.com/sse自定义请求头可选按AuthorizationBearer xxx每行一条用于鉴权保存即可第三步连接 StreamableHTTP 服务器StreamableHTTP 是更新的远程协议支持双向流式传输配置方式与 SSE 类似传输协议选择StreamableHTTP端点地址填写 URL如https://mcp.example.com/mcp如需鉴权在自定义请求头中添加AuthorizationBearer 你的令牌保存后测试连接 在内部存储中StreamableHTTP 与 http 类型统一归为http传输见 src/types/mcp.ts 中的McpTransport定义。进阶JSON 一键导入批量配置如果已有现成的 MCP 配置例如从其他工具导出的mcpServers格式可以直接粘贴 JSON 导入支持批量添加。弹窗中的导入创建标签页接受标准格式{ mcpServers: { my-tool: { command: npx, args: [-y, some/mcp-server], env: { API_KEY: your-key } }, remote-server: { type: sse, url: https://mcp.example.com/sse }, http-server: { type: streamablehttp, url: https://mcp.example.com/mcp, headers: { Authorization: Bearer xxx } } } }AQBot 会自动识别command判定为 stdio、typesse/streamablehttp/http与url/endpoint字段一次粘贴、多个服务器全部导入成功识别逻辑见 McpServerSettings.tsx。掌握权限策略与超时参数权限策略每个服务器可独立设置permissionPolicy决定工具调用时是否需要人工确认策略行为每次询问ask每次工具调用前弹窗确认最安全允许安全操作allow_safe只读类操作直接放行敏感操作仍需确认允许全部allow_all全部自动执行适合可信本地工具超时设置发现超时discoverTimeoutSecs5~300 秒用于连接服务器并获取工具列表执行超时executeTimeoutSecs5~600 秒限制单次工具调用的最长耗时网络较慢的远程服务器建议适当调大发现超时执行耗时较长的工具如批量爬取调大执行超时即可。工具循环上限在设置 → 对话中可以限制单次回复中模型连续调用 MCP 工具的轮数。数值较低可减少耗时和成本数值较高适合更长的自动化工具流程。开箱即用AQBot 内置工具AQBot 自带两个无需安装的 MCP 工具服务器在服务器列表的内置工具分组中默认显示打开开关即可使用aqbot/fetch — 网页抓取工具说明fetch_url抓取指定 URL 的页面内容提取文本fetch_markdown抓取页面并转换为 Markdownaqbot/search-file — 文件操作工具说明read_file读取指定路径的文件内容list_directory列出目录下的文件和文件夹search_files按模式搜索匹配的文件在对话中使用 MCP 工具普通对话与 Agent 模式的区别普通对话勾选 MCP 服务器后工具会提供给模型默认权限策略下每次调用前会请求确认。普通 Chat 的 MCP 链路不会执行终端命令。Agent 模式在输入框底部切换到 AgentMCP 工具会与内置 Agent 工具读写文件、执行命令一起提供给模型工作目录是进程起始 CWD而非文件系统沙箱。工具执行面板当模型调用 MCP 工具时消息中会出现工具执行面板展示工具名称— 被调用的工具和所属服务器输入参数— 模型传给工具的参数执行状态— 等待确认、执行中、已完成或失败返回结果— 工具执行后返回的数据点击面板可展开查看完整输入输出方便调试 AI 的工具使用行为。常见问题排查Q1连接测试失败怎么办先在设置页运行连接测试查看具体报错stdio 服务器确认命令在本机终端能直接运行npx/uvx是否已安装SSE/StreamableHTTP确认 URL 可达、请求头鉴权正确首次拉取工具较慢时适当调大发现超时Q2工具列表是空的确认服务器开关已打开然后点击刷新工具重新发现工具。部分服务器需要重启后才会暴露完整工具集。Q3如何停用某个工具不需要删除服务器直接把开关关闭即可配置保留随时可再启用。Q4远程服务器需要鉴权在自定义请求头中按KEYVALUE格式每行一条添加最常见的就是AuthorizationBearer 令牌。总结你的需求推荐配置用npx/uvx跑本地工具stdio 命令/参数连接公司托管的远程 MCPSSE URL 请求头使用新版远程 MCP 服务StreamableHTTP URL从其他客户端迁移配置JSON 导入批量粘贴通过本文的步骤你可以在 AQBot 中快速接好 stdio、SSE 与 StreamableHTTP 三类工具服务器配合权限策略与超时参数安全地把 AI 的能力延伸到文件、网页与数据库等外部世界。更多细节可参考官方文档 website/docs/zh/guide/mcp.md数据流实现见 src/stores/mcpStore.ts。赞分享【免费下载链接】AQBot☁️ 轻量级高性能跨平台AI对话 AI Agent AI网关桌面客户端 | Lightweight, high-performance cross-platform AI dialogue AI Agent AI gateway desktop client项目地址https://gitcode.com/gh_mirrors/aq/AQBot点击查看免费下载相关推荐Agent TARS 桌面端 MCP 服务器配置完全指南从 STDIO 到 SSE 的模型上下文协议接入实战Agent TARS 桌面端 MCP 服务器配置完全指南从 STDIO 到 SSE 的模型上下文协议接入实战 本文是一份面向 Agent TARSUI TA人工智能大模型AI Agent自主智能体多模态GUI自动化浏览器控制桌面应用把一份 DESIGN.md 丢给 AI 代理73 个品牌 UI 风格照单生成把一份 DESIGN.md 丢给 AI 代理73 个品牌 UI 风格照单生成 你让 AI 代理写个落地页出来的配色发飘、标题字阶忽大忽小、按钮风格前后不一致文档Skill Seeker MCP 服务器 HTTP 传输完整指南stdio 与 SSE 双模式部署实践Skill Seeker MCP 服务器 HTTP 传输完整指南stdio 与 SSE 双模式部署实践 Skill Seeker 的 MCP 服务器Fast人工智能AI 应用AI 技能MCP 服务RAG数据工程网页爬虫上一篇Noto字体终极指南如何用一款字体完美支持全球100语言下一篇网盘直链下载助手终极指南告别客户端轻松获取八大网盘真实链接创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
