.mcp.json是 Model Context Protocol（MCP，模型上下文协议）的标准配置文件，用于给开发环境中的 AI Agent（如 deepagentcode）挂载扩展工具能力。
一、 配置项与参数详解
配置文件根层级为mcpServers，其下定义了 4 个不同的服务节点：
1. HTTP 远程类型服务 (docs-langchain&reference-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 langchain | HTTP 远程服务 | 无（只读查询） | 解决大模型对 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 Token（GITHUB_PERSONAL_ACCESS_TOKEN），请确保在运行 deepagentcode 的终端环境或配置中已暴露该变量。路径跨平台兼容：
filesystem中配置的是 Linux/macOS 风格的/tmp路径。若在 Windows 环境下运行，建议将其替换为 Windows 目录（如C:\\Users\\<UserName>\\AppData\\Local\\Temp）。
