MCP Server 入门：5 分钟搞定 AI Agent 工具扩展

2026-06-24 · mcp tutorial beginner claude code

MCP Server 是 AI Agent 的"工具箱"——装上它，你的 AI 就能操作浏览器、读写数据库、调用 API。

什么是 MCP？

MCP（Model Context Protocol）是 Anthropic 在 2024 年发布的开放标准。它让 AI Agent 能和外部工具通信——就像给 AI 装了一个"USB-C 接口"。

类比： - Skill = 教 AI 怎么做某件事（知识） - MCP Server = 给 AI 一个工具去做某件事（能力）

为什么要用 MCP？

没有 MCP 的 AI Agent 只能读写本地文件。有了 MCP，它可以： - 🔍 浏览网页（Playwright MCP） - 📊 查询数据库（PostgreSQL/MySQL MCP） - 🐙 操作 GitHub（Issue、PR、Repo） - 📁 访问远程文件系统 - 🔎 搜索实时信息

5 分钟安装教程

Step 1: 选一个 MCP Server

新手推荐从这几个开始：

MCP Server	功能	GitHub Stars
Filesystem	读写本地文件	87K
GitHub	操作 Issue/PR/Repo	30K
Playwright	浏览器自动化	34K
Context7	获取最新库文档	57K
Chrome DevTools	调试网页	44K

Step 2: 安装 MCP Server

以 Filesystem MCP 为例：

# macOS / Linux
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory

# Windows
npx -y @modelcontextprotocol/server-filesystem C:\Users\YourName\Projects

Step 3: 配置 Claude Code

# 添加 MCP Server
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/project

Step 4: 验证安装

重启 Claude Code，输入：

帮我看看当前目录有什么文件

如果 AI 能列出文件，说明 MCP 安装成功。

配置 Claude Desktop

如果你用 Claude Desktop（不是 CLI），需要编辑配置文件：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

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

保存后重启 Claude Desktop，看右上角有没有 🔨 图标。

进阶：同时用多个 MCP Server

你可以在配置里添加多个 Server：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-playwright"]
    }
  }
}

MCP vs Skills：什么时候用哪个？

场景	用 MCP	用 Skill
让 AI 读写文件	✅ Filesystem MCP	❌
让 AI 写更好的测试	❌	✅ TDD Skill
让 AI 操作 GitHub	✅ GitHub MCP	❌
让 AI 遵循代码规范	❌	✅ Coding Standards Skill
让 AI 浏览网页	✅ Playwright MCP	❌

最佳实践：MCP + Skill 配合使用。MCP 给工具，Skill 教方法。

新手常犯的错误

装太多 MCP Server — 每个 Server 都会占用资源，建议从 2-3 个开始
不看权限 — Filesystem MCP 可以读写文件，确保只授权必要的目录
不重启 — 修改配置后必须重启 Claude Desktop/Code