← 回到成长记录
工具·

Claude Code MCP 入门指南：给AI装上插件，能力翻倍

#Claude Code#AI编程#MCP#插件扩展

Claude Code MCP 入门指南：给AI装上插件，能力翻倍

学习来源：跟老金老师学的 Claude Code 系列课程

Claude Code 本身已经很能打了——能读文件、能写代码、能跑命令。但有了 MCP，它的能力直接再上一个台阶。

一、MCP 是个啥？用买菜来理解

MCP（Model Context Protocol）是 Anthropic 推出的AI工具扩展协议。说人话就是给AI装插件。

最好理解的方式是类比：

概念类比说明
Claude Code你的手机核心设备
MCP 协议应用商店标准统一接口规范
MCP 服务器手机App各种扩展功能
配置文件的 MCP 配置安装App装上就能用

没装MCP的Claude Code = 只能读写本地文件、跑跑命令 装了MCP的Claude Code = 能查数据库、操作GitHub、搜网页、调API……

跟直接在对话里让AI"帮我查一下"的区别在于：MCP 让AI 自己就能完成这些操作，不需要你手动贴数据。

二、MCP 到底能干什么？真实场景说话

场景1：报错时自动查GitHub Issues

# 装了 GitHub MCP 后
> 这个报错我怀疑是个已知Bug，帮我查查 GitHub Issues 里有没有人遇到过
# AI 自动搜索 GitHub Issues，找到相关讨论，给出解决方案

场景2：直接连数据库查数据

# 装了数据库 MCP 后
> 帮我查一下 users 表里最近一周注册的用户数
# AI 自动连数据库、执行SQL、返回结果

场景3：搜索最新技术文档

# 装了 Web Search MCP 后
> Next.js 15 有哪些新特性？帮我查一下官方文档
# AI 自动搜索网页，获取最新信息，而不是依赖训练数据

场景4：操作外部API

# 装了对应的 MCP 后
> 帮我用 Jira API 查一下这个Sprint还有哪些未完成的任务
# AI 调用 Jira API，返回实时数据

三、配置文件详解

MCP 的配置文件在项目根目录的 claude.json（也可以放在 ~/.claude/claude.json 全局配置）：

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/mcp-server", "--option", "value"],
      "env": {
        "API_KEY": "your-key-here"
      }
    }
  }
}

字段说明：

字段必须说明
mcpServers✅所有MCP服务器的配置入口
server-name✅自定义服务器名称，用来标识
command✅启动命令（npx、node、python等）
args✅命令参数数组
env❌环境变量配置（存放API密钥等敏感信息）

⚠️ 安全提示： API密钥这类敏感信息请放在 env 字段或 .env 文件中，不要硬编码在args里。

四、实战配置：6个我最常用的MCP服务器

1. Filesystem — 增强文件操作

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

能干什么： 更精细的文件读写、目录遍历、文件搜索（比Claude Code自带的文件操作更灵活）

2. GitHub — 操作GitHub仓库

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_你的token"
      }
    }
  }
}

能干什么：

  • 搜索 Issues 和 PR
  • 查看代码、创建 PR
  • 管理 Releases
  • 操作 Repository

使用场景：

> 帮我看看这个仓库有没有关于"rate limit"的Issues
> 给这个Issue回复一下我的排查结果

3. PostgreSQL — 直接连数据库

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost:5432/mydb"]
    }
  }
}

能干什么：

  • 执行SQL查询
  • 查看表结构
  • 分析数据

使用场景：

> 帮我查查 orders 表的结构
> 写一个SQL：统计上个月每个月的销售额趋势
> 分析一下有没有慢查询

⚠️ 注意： 生产数据库不要随便连！建议只用读权限账号连测试环境或只读副本。

4. Web Search — 联网搜索

{
  "mcpServers": {
    "web-search": {
      "command": "npx",
      "args": ["-y", "@anthropic/server-search"]
    }
  }
}

能干什么：

  • 搜索最新技术文档
  • 查实时数据
  • 找开源项目

使用场景：

> 查一下 React 19 的最新稳定版发布了没有
> 搜索一下"Next.js parallel routes"的最佳实践

5. Memory — 知识持久化

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

能干什么：

  • 让AI记住跨会话的信息
  • 保存项目规范和约定
  • 记住你的偏好配置

使用场景：

> 记住：这个API默认返回分页数据，每页20条
> 记住我们项目的命名规范：文件名用kebab-case，组件名用PascalCase

6. Puppeteer — 浏览器自动化

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

能干什么：

  • 截图网页
  • 提取页面内容
  • 执行浏览器操作

使用场景：

> 帮我截取一下这个页面的截图：http://localhost:3000
> 抓取这个页面的主要内容，提取成Markdown

五、MCP 服务器速查表

服务器用途安装方式推荐度
server-filesystem文件操作npx⭐⭐⭐⭐⭐
server-githubGitHub集成npx⭐⭐⭐⭐⭐
server-postgresPostgreSQLnpx⭐⭐⭐⭐
server-sqliteSQLitenpx⭐⭐⭐
server-puppeteer浏览器自动化npx⭐⭐⭐⭐
server-memory知识持久化npx⭐⭐⭐⭐
server-search网页搜索npx⭐⭐⭐⭐
server-filesystem-search文件搜索npx⭐⭐⭐

六、管理MCP的命令

配置好后，在交互模式中用以下命令管理：

# 查看所有已连接的MCP服务器
> /mcp

# 重启某个MCP服务器（如果出问题了）
> /mcp restart server-name

# 检查某个MCP服务器的状态
> /mcp status server-name

首次配置后的最佳实践：

  1. 先配置好 claude.json
  2. 重启Claude Code让配置生效
  3. 输入 /mcp 检查服务器连接状态
  4. 如果显示 connected 就说明成功了
  5. 如果显示 error，检查路径和参数是否正确

七、常见问题

Q: MCP服务器启动失败怎么办？ A: 三步排查：① 检查命令和路径是否正确 ② 检查端口是否被占用 ③ 运行 /doctor 检查系统状态

Q: 多个项目都需要相同的MCP配置怎么办？ A: 可以配置在全局 ~/.claude/claude.json 中，所有项目自动生效。项目级的 claude.json 会覆盖全局配置。

Q: MCP服务器安全吗？ A: 每个MCP服务器只获得你授予的权限。比如GitHub MCP只操作你授权的仓库，PostgreSQL MCP只连你配置的数据库。但建议：

  • 生产环境数据库不要给写权限
  • API密钥用 env 字段管理，不要硬编码
  • 只安装可信来源的MCP服务器

Q: 一个项目能同时配置多个MCP服务器吗？ A: 可以！claude.json 里可以配任意多个。比如我同时配了GitHub + Database + Search，一个会话里都能用。

Q: MCP服务器需要自己维护吗？ A: 大部分通过 npx 运行的MCP服务器会自动更新，基本不需要维护。如果遇到问题，重启Claude Code一般能解决。

八、总结

MCP 让 Claude Code 从"只能操作本地文件"变成"能连接各种外部工具"：

  • 装插件 → 在 claude.json 中配置MCP服务器
  • 用插件 → AI自动调用，你只需要提需求
  • 管插件 → /mcp 命令查看和管理

建议先从 filesystem 和 github 两个MCP服务器入手，体验一下AI"能力扩展"的感觉，再逐步增加其他服务器。

本文学自老金老师的Claude Code系列教程。

💬 评论

评论功能开发中，欢迎去GitHub提 issue。