本地 MCP 开发环境最佳实践
本地配置文件详解
全局配置 vs 项目级配置
Claude Code 支持两种配置方式，各有适用场景。
| 配置类型 | 文件位置 | 适用场景 |
|---|---|---|
| 全局配置 | ~/.claude/settings.json |
所有项目通用的 Server |
| 项目级配置 | 项目根目录/.claude.json |
项目特定的 Server |
配置优先级：
- 项目级配置会与全局配置合并
- 相同 Server 名称时，项目级覆盖全局
settings.json 结构
全局配置文件示例：
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/Documents"]
},
"git": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-git", "--repository", "/home/user/Projects"]
}
}
}
配置字段说明：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
command |
string | 是 | 启动命令 |
args |
array | 否 | 命令参数 |
env |
object | 否 | 环境变量 |
cwd |
string | 否 | 工作目录 |
环境变量与密钥管理
敏感信息应该通过环境变量传递，而非硬编码。
错误示例（硬编码）：
AI 编程知识库会员专享内容
开通后解锁「本地 MCP 开发环境最佳实践」全文，AI 编程知识库全年访问
扫码添加企业微信，找大熊掌门开通会员
添加后说明想开通的会员类型即可