一、MCP 工具概念MCPModel Context Protocol模型上下文协议是一种开放协议允许你从外部服务器向 Deep Agents CodeLangChain 的 AI 代理开发环境动态加载额外工具。核心思想不修改代理代码本身就能让 AI 获得操作文件系统、调用 API、查询数据库等外部能力。Deep Agents Code 启动时会自动连接配置的 MCP 服务器发现其提供的工具并将它们与内置工具合并供代理使用。二、MCP 的作用作用维度说明能力扩展让 AI 代理突破内置工具限制连接外部系统即插即用通过配置文件添加/移除工具无需改代码安全隔离工具在独立进程中运行stdio 模式或通过网络连接HTTP/SSE 模式权限管控支持项目级信任机制防止恶意仓库自动执行危险命令三、有哪些工具工具取决于你连接的MCP 服务器文档中提到的典型工具包括服务器提供的工具示例用途docs-langchain文档检索工具查询 LangChain 概念指南、教程reference-langchainAPI 参考工具查询类、方法、参数定义filesystemread_file、list_directory读写本地文件系统github仓库管理、Issue 操作等与 GitHub 交互databaseSQL 查询、数据操作连接远程数据库linear、slack、notion项目管理、消息发送连接第三方 SaaS 服务需 OAuth注意实际可用工具以服务器暴露的为准可通过allowedTools和disabledTools进行过滤。四、能解决什么实际问题AI 需要读写本地文件比如让代理自动读取项目代码、生成报告文件AI 需要操作 GitHub自动创建 PR、评论 Issue、查询仓库状态AI 需要查询数据库让代理直接执行 SQL 获取业务数据进行分析AI 需要实时文档支持连接 LangChain 官方文档 MCP让代理基于最新文档回答技术问题AI 需要集成第三方服务通过 OAuth 连接 Slack、Notion、Linear 等实现跨系统自动化五、运用到哪些项目中Deep Agents Code 会话作为 LangChain 官方推荐的代理开发环境需要文件操作的 AI 项目代码生成、文档处理、数据分析代理DevOps 自动化项目GitHub 仓库管理、CI/CD 辅助企业知识库项目连接内部数据库或文档系统多工具协作的复杂代理需要同时操作文件、API、数据库的综合性 AI 应用六、命令和配置参数详解核心命令命令作用dcode启动 Deep Agents Code自动发现并加载 MCP 配置dcode mcp login server对需要 OAuth 认证的服务器执行登录流程/mcp在交互会话中查看各服务器状态、工具列表dcode --mcp-config path显式指定 MCP 配置文件路径dcode --no-mcp完全禁用 MCP 加载dcode --trust-project-mcp跳过项目级 MCP 的信任提示非交互模式常用配置文件.mcp.json配置文件可放在三个位置优先级由低到高~/.deepagents/.mcp.json— 用户级所有项目共享project/.deepagents/.mcp.json— 项目级隐藏目录project/.mcp.json— 项目级根目录与 Claude Code 兼容关键配置参数{mcpServers:{server-name:{// 传输类型stdio默认| sse | httptype:http,// stdio 模式本地命令command:npx,args:[-y,modelcontextprotocol/server-filesystem,/tmp],env:{KEY:value},// 远程模式SSE/HTTP 服务器地址url:https://api.example.com/mcp,headers:{Authorization:Bearer ${TOKEN}},// OAuth 认证仅远程服务器auth:oauth,// 工具过滤二选一allowedTools:[read_file,list_*],disabledTools:[delete_*]}}}参数含义type/transport通信方式stdio本地子进程、sseServer-Sent Events、http流式 HTTPcommandstdio 模式下要执行的命令如npxargs传递给命令的参数数组env子进程环境变量用于安全传递 API Keyurl远程 MCP 服务器端点headersHTTP 请求头支持${VAR}环境变量插值auth设为oauth时启用 OAuth 登录流程与Authorization头互斥allowedTools白名单仅保留列出的工具支持fnmatch通配符disabledTools黑名单禁用列出的工具七、实际案例配置文件系统 GitHub 工具假设你需要让 AI 代理能够读取本地项目文件并管理 GitHub 仓库配置如下1. 创建配置文件在用户目录创建~/.deepagents/.mcp.json{mcpServers:{filesystem:{command:npx,args:[-y,modelcontextprotocol/server-filesystem,/home/user/projects],allowedTools:[read_file,list_directory]},github:{command:npx,args:[-y,modelcontextprotocol/server-github],env:{GITHUB_TOKEN:ghp_xxxxxxxxxxxx}}}}2. 启动并验证# 启动 Deep Agents Code自动加载 MCP 服务器dcode# 你会看到类似输出# ✓ Loaded 5 MCP tools# 在交互会话中查看状态/mcp3. 实际使用场景启动后你的 AI 代理现在可以读取文件请读取 /home/user/projects/myapp/src/main.py 的内容并分析列出目录查看 myapp 项目下有哪些配置文件GitHub 操作帮我查看 langchain-ai/langchain 仓库最近的 5 个 Issue代理会自动调用对应的 MCP 工具完成这些操作无需你手动编写任何 API 调用代码。4. 安全注意事项filesystem服务器限制了allowedTools仅允许读取和列出目录禁止写入/删除GitHub Token 通过env传递不会暴露在命令历史或配置文件的版本控制中如果是项目级配置首次启动时 Deep Agents Code 会提示你确认信任防止恶意仓库执行危险命令学习路径入门先配置docs-langchain和reference-langchain让 AI 能查官方文档进阶添加filesystem服务器让 AI 能操作本地文件实战根据项目需求接入github、database或第三方 SaaS 服务安全理解allowedTools过滤和项目级信任机制确保生产环境安全