.mcp.json是 Model Context ProtocolMCP模型上下文协议的标准配置文件用于给开发环境中的 AI Agent如 deepagentcode挂载扩展工具能力。一、 配置项与参数详解配置文件根层级为mcpServers其下定义了 4 个不同的服务节点1. HTTP 远程类型服务 (docs-langchainreference-langchain)docs-langchain: { type: http, url: https://docs.langchain.com/mcp }配置参数含义type: http指定通信方式为 HTTP/SSE 服务工具托管在远程服务器上本地无需安装依赖包。url远程 MCP 服务端的端点接口地址。实际解决的问题消除模型幻觉与过时知识大模型训练数据有截止时间直接问 LangChain 新版的 API 容易胡编乱造。该工具允许 Agent 在对话时直接实时检索和读取最新的 LangChain 官方文档与 API Reference。适用项目场景基于LangChain / LangGraph开发大模型应用、Agent 工作流、RAG 系统时。需要频繁查阅最新 API 接口、配置参数和官方示例代码的开发场景。2. 本地文件系统服务 (filesystem)filesystem: { command: npx, args: [-y, modelcontextprotocol/server-filesystem, /tmp], allowedTools: [read_file, list_directory] }配置参数含义command: npx指定通过 Node.js 的npx命令行工具动态启动本地进程。args-y自动同意下载并安装包。modelcontextprotocol/server-filesystem官方提供的文件系统 MCP 服务包。/tmp沙箱限制目录该服务只允许 Agent 访问本地系统的/tmp路径保障宿主机安全性。allowedTools白名单机制仅允许 Agent 使用读取文件 (read_file) 和列出目录 (list_directory) 的工具阻断写文件、删文件等高危操作。实际解决的问题安全受控的文件读取赋予 Agent 检查本地日志、临时文件、中间数据或导出结果的能力同时严格限制其操作边界不能越权读取用户主目录或敏感文件。适用项目场景需要让 Agent 分析本地生成的调试日志如/tmp/debug.log。自动化处理临时文件、中间数据分析、数据清洗排错等任务。3. GitHub 整合服务 (github)github: { command: npx, args: [-y, modelcontextprotocol/server-github], disabledTools: [delete_repository, delete_*_branch] }配置参数含义command与args调用官方 GitHub MCP 服务包使 Agent 能够通过 GitHub API 与远端仓库互动。disabledTools黑名单机制禁用删除仓库 (delete_repository) 以及删除分支 (delete_*_branch) 等高风险破坏性动作。实际解决的问题代码库联动与自动化运维让 Agent 具备跨仓库检索代码、读取 Issue、查看 PR 变更、搜索仓库文件等能力免去手动切浏览器查 GitHub 的过程。适用项目场景开源项目维护与协作Agent 帮排查 GitHub Issue、分析用户反馈的代码 Bug。代码审查与重构Agent 读取远端分支的 Commit/PR 进行 Code Review并生成修改建议。多仓库技术调研在 GitHub 上检索特定库的用法或源码实现。二、 核心参数对比总结配置项通信模式权限控制机制解决的核心问题典型应用项目docs / reference langchainHTTP 远程服务无只读查询解决大模型对 LangChain API 的幻觉与版本滞后LangChain / Agent / RAG 开发filesystem本地 CLI 进程allowedTools白名单限制在/tmp允许 Agent 读取特定临时文件阻断写删危险本地日志排错、临时文件分析github本地 CLI 进程disabledTools黑名单阻断删库操作赋予 Agent 检索 GitHub 仓库、PR、Issue 的能力代码审查、开源项目维护、Issue 排查三、 使用注意事项GitHub 鉴权modelcontextprotocol/server-github通常需要通过环境变量传入 GitHub Personal Access TokenGITHUB_PERSONAL_ACCESS_TOKEN请确保在运行 deepagentcode 的终端环境或配置中已暴露该变量。路径跨平台兼容filesystem中配置的是 Linux/macOS 风格的/tmp路径。若在 Windows 环境下运行建议将其替换为 Windows 目录如C:\\Users\\UserName\\AppData\\Local\\Temp。