人工智能AI AgentAI 应用多智能体Agent 编排Agent 沙箱Agent 记忆AI 技能【免费下载链接】deerflow2.0-enhancedDeerFlow 2.0 Enhanced - Chinese localization New skills项目地址https://gitcode.com/gh_mirrors/de/deerflow2.0-enhanced点击查看免费下载 面向新手用户的 DeerFlow 2.0 Enhanced中文增强版MCP 接入教程3 步完成配置支持 stdio / SSE / HTTP 三种传输方式与 OAuth 自动认证让 AI 智能体自由调用外部工具。DeerFlow 2.0 Enhanced 是一个基于多智能体协作的 AI 应用框架通过接入 MCPModel Context Protocol服务器可以为智能体扩展文件系统、数据库、外部 API、浏览器自动化等能力。本文将带你从零开始用最简单的方式为 DeerFlow 接入 MCP 服务器并完整讲透三种传输方式与 OAuth 认证配置。一、为什么需要给 DeerFlow 接入 MCP 服务器MCP 服务器本质上是一个工具提供者它对外暴露一组标准化工具toolsDeerFlow 会在运行时自动发现这些工具并注入到智能体系统中无需修改任何代码。接入后你的智能体可以能力类别典型 MCP 服务器示例场景 文件系统server-filesystem读写指定目录内的文件 数据库server-postgres查询 PostgreSQL 数据 外部 APIserver-github仓库操作、Issue 管理️ 浏览器自动化Puppeteer 等网页抓取与截图 自建服务自定义实现企业内部系统集成核心实现位于 backend/packages/harness/deerflow/mcp/ 目录官方说明文档见 backend/docs/MCP_SERVER.md。二、快速上手3 步完成 MCP 服务器接入第 1 步复制示例配置文件项目根目录已提供现成的示例配置只需复制一份并改名cp extensions_config.example.json extensions_config.json这个示例文件 extensions_config.example.json 中预置了 3 个常见服务器模板filesystem文件系统、githubGitHub 操作、postgres数据库全部默认关闭。第 2 步启用并修改配置打开extensions_config.json把要使用的服务器enabled改为true并按需修改command、args、env字段。例如启用 filesystem{ mcpServers: { filesystem: { enabled: true, type: stdio, command: npx, args: [-y, modelcontextprotocol/server-filesystem, /path/to/allowed/files], description: 提供允许目录内的文件系统访问 } } }第 3 步重启应用加载工具重启 DeerFlow 后MCP 服务器暴露的工具会自动注册给智能体随后可直接在对话中让 Agent 使用这些工具。小贴士配置变更会被自动检测——DeerFlow 通过监听extensions_config.json的文件修改时间mtime来判断缓存是否失效修改配置后工具会被自动重新加载很多场景下无需手动重启。热更新逻辑见 backend/packages/harness/deerflow/mcp/cache.py。三、三种传输方式详解stdio、SSE、HTTPDeerFlow 通过type字段识别传输类型支持stdio、sse、http三种。参数构建逻辑位于 backend/packages/harness/deerflow/mcp/client.py配置模型定义在 backend/packages/harness/deerflow/config/extensions_config.py。3.1 stdio本地命令行启动默认方式DeerFlow 会在本地直接启动一个子进程通过标准输入/输出与之通信。适合 npx、uvx 等本地工具必须提供command字段缺少会报错requires command field。{ type: stdio, command: npx, args: [-y, modelcontextprotocol/server-github], env: { GITHUB_TOKEN: $GITHUB_TOKEN } }必填字段command启动命令、args参数列表可选字段env传给子进程的环境变量。3.2 SSE / HTTP连接远程服务器当 MCP 服务器部署在远端或云端服务时使用url字段指向服务端点必须提供url缺少会报错requires url field{ type: http, url: https://api.example.com/mcp, headers: { X-Api-Key: 你的密钥 } }sseServer-Sent Events 单向推送适合需要流式事件的场景http标准 HTTP 传输Streamable HTTP是目前远程 MCP 的主流选择headers可携带任意自定义请求头例如静态Authorization令牌3.3 三种传输方式对比特性stdioSSEHTTP部署位置本地进程远程服务远程服务关键字段commandargsurlurl是否支持 OAuth❌✅✅典型用途npx/uvx 本地工具流式推送服务云端 MCP 服务⚠️ 填写了不识别的type如websocket会抛出unsupported transport type错误请只用以上三种。四、OAuth 认证让远程 MCP 服务器更安全连接需要鉴权的http/sse服务器时DeerFlow 内置了OAuth 令牌自动获取与自动续期能力启动时自动拉取令牌在过期前默认提前 60 秒自动刷新并注入到每次工具调用的Authorization请求头中全程无需手动维护令牌。完整实现见 backend/packages/harness/deerflow/mcp/oauth.py。4.1 支持的授权模式授权类型说明必填项client_credentials客户端凭证模式服务间调用首选client_idclient_secretrefresh_token刷新令牌模式适合长期运行的服务refresh_token4.2 完整配置示例{ mcpServers: { secure-http-server: { enabled: true, type: http, url: https://api.example.com/mcp, oauth: { enabled: true, token_url: https://auth.example.com/oauth/token, grant_type: client_credentials, client_id: $MCP_OAUTH_CLIENT_ID, client_secret: $MCP_OAUTH_CLIENT_SECRET, scope: mcp.read, refresh_skew_seconds: 60 } } } }关键字段速查token_urlOAuth 令牌端点地址scope/audience令牌权限范围与受众按服务商要求填写refresh_skew_seconds提前多少秒刷新令牌默认 60token_field/expires_in_field自定义令牌响应字段名应对非标准 OAuth 服务五、密钥安全最佳实践用环境变量代替明文配置中的$变量名会被自动解析为对应环境变量因此强烈建议把敏感信息放到环境变量里export GITHUB_TOKENghp_xxxxxxxxxxxx export MCP_OAUTH_CLIENT_IDyour-client-id export MCP_OAUTH_CLIENT_SECRETyour-client-secret解析逻辑位于 backend/packages/harness/deerflow/config/extensions_config.py 中的resolve_env_variables。若环境变量未设置占位符会被替换为空字符串而不是原文$VAR避免假的令牌被传给服务器。六、通过 Web 界面或 API 管理 MCP 服务器除了改文件DeerFlow 还提供两条零代码管理通道设置页面前端 设置 → 工具Tools页面可以一键开关每个 MCP 服务器页面实现见 frontend/src/components/workspace/settings/tool-settings-page.tsxREST APIGET /api/mcp/config查看当前所有服务器配置PUT /api/mcp/config整体更新配置并自动落盘API 路由实现位于 backend/app/gateway/routers/mcp.py接口文档详见 backend/docs/API.md。七、常见问题排查报错 / 现象原因解决方法requires command fieldstdio 类型未填command补上启动命令如npxrequires url fieldsse/http 类型未填url补上服务器地址unsupported transport typetype写了非法值只使用stdio/sse/http工具列表为空服务器enabled为false改为true并重启langchain-mcp-adapters not installed缺少依赖包执行pip install langchain-mcp-adaptersOAuth 提示缺少client_idclient_credentials模式缺凭证配置client_id与client_secret️ 排查技巧单个服务器配置错误只会被跳过并记录错误日志不会影响其他正常服务器可以放心逐个排查。八、总结步骤操作关键点①复制extensions_config.example.json得到extensions_config.json②选择传输方式填写字段stdio 填commandsse/http 填url③远程服务器配置 OAuth令牌自动获取与刷新④重启或用设置页/API 管理工具自动发现、热更新只需一份 JSON 配置DeerFlow 就能把任意 MCP 服务器暴露的工具无缝接入智能体系统。建议从stdio本地服务器练手再逐步过渡到带 OAuth 认证的远程http服务器构建出既强大又安全的 AI 工具生态。赞分享人工智能AI AgentAI 应用多智能体Agent 编排Agent 沙箱Agent 记忆AI 技能【免费下载链接】deerflow2.0-enhancedDeerFlow 2.0 Enhanced - Chinese localization New skills项目地址https://gitcode.com/gh_mirrors/de/deerflow2.0-enhanced点击查看免费下载相关推荐Skill Seeker MCP 服务器 HTTP 传输完整指南stdio 与 SSE 双模式部署实践Skill Seeker MCP 服务器 HTTP 传输完整指南stdio 与 SSE 双模式部署实践 Skill Seeker 的 MCP 服务器Fast人工智能AI 应用AI 技能MCP 服务RAG数据工程网页爬虫如何给BrainPilot接入MCP工具stdio、http、sse三种传输方式实战指南如何给BrainPilot接入MCP工具stdio、http、sse三种传输方式实战指南 BrainPilot 是一款面向脑科学与认知科学的 AI 研究智能体如何为 Echo Agent 接入 MCP 外部工具stdio 与 HTTP 双传输配置完整教程如何为 Echo Agent 接入 MCP 外部工具stdio 与 HTTP 双传输配置完整教程 Echo Agent 是一个面向长期运行与桌面协作的开源 A人工智能AI Agent大模型Agent 记忆工具调用RAGMCP 服务MCP ClientsAI 评测多智能体任务调度即时通讯上一篇字体版权不用愁Montserrat 开源字体从下载到自定义的 20 分钟上手路线下一篇peon-ping 的 oh-my-piomp适配器ExtensionAPI 事件桥接 peon.sh 的完整实现解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
