[claude code] 05 实战篇：MCP 服务器与技能扩展

05 实战篇：MCP 服务器与技能扩展

通过 MCP 连接外部世界，用 Skills 扩展 Claude 的能力边界。

5.1 MCP 协议概念

MCP（Model Context Protocol）是 Anthropic 的开源协议，标准化 AI 模型与外部数据源的交互方式。

核心概念

Claude Code ←→ MCP Server ←→ 外部服务 (客户端) (中间层) (数据源)

• MCP Server：一个独立进程，提供工具（Tools）和资源（Resources）
• 传输方式：stdio（本地进程通信）或 HTTP（网络通信）
• 协议：JSON-RPC 2.0

MCP 能做什么

5.2 添加与管理 MCP 服务器

添加 stdio 服务器（本地进程）

# 基本格式claude mcpadd<名称><命令>[参数...]# 示例：添加 GitHub MCPclaude mcpaddgithub-y@modelcontextprotocol/server-github# 示例：添加带环境变量的服务器claude mcp add-json brave-search'{ "command": "npx", "args": ["-y", "brave-search-mcp"], "env": { "BRAVE_API_KEY": "your-api-key" } }'

添加 HTTP 服务器（远程服务）

# 基本 HTTP 服务器claude mcpadd--transporthttp my-server https://api.example.com/mcp# 带认证头的 HTTP 服务器claude mcpadd--transporthttp\--header"Authorization: Bearer your-token"\my-server https://api.example.com/mcp

指定作用范围

# 全局（所有项目可用）claude mcpadd--scopeuser github-y@modelcontextprotocol/server-github# 仅当前项目claude mcpadd--scopeproject my-db-y@modelcontextprotocol/server-postgres

管理命令

# 列出所有已配置的服务器claude mcp list# 查看服务器详情claude mcp get github# 移除服务器claude mcp remove github# 在对话中检查服务器状态/mcp

配置文件

全局配置~/.claude.json：

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

项目配置.mcp.json（项目根目录）：

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

最佳实践：

• 全局通用的服务器用--scope user（如 GitHub、搜索）
• 项目特定的服务器用--scope project（如数据库、内部 API）
• 敏感信息（API Key）放在env中，不要硬编码在命令行
• 定期用/mcp检查服务器状态，移除不用的服务器

5.3 常用 MCP 服务器推荐

开发工具类

搜索与信息类

设计与协作类

基础设施类

5.4 Skills 技能体系

Skills 是 Claude Code 的可扩展能力包，按需加载，节省 token。

技能类型

技能目录结构

my-skill/ ├── SKILL.md # 必需：指令和元数据 ├── scripts/ # 可选：可执行脚本 ├── references/ # 可选：参考文档 └── assets/ # 可选：模板、资源

SKILL.md 格式

--- name: code-review description: 代码审查技能，检查安全、性能和可维护性 triggers: - "review code" - "审查代码" - "code review" --- # 代码审查技能 ## 审查维度 1. **安全性**：SQL 注入、XSS、敏感信息泄露 2. **性能**：N+1 查询、内存泄漏、不必要的循环 3. **可维护性**：函数长度、命名规范、注释质量 4. **错误处理**：异常捕获、边界条件、资源释放 ## 审查流程 1. 读取目标文件 2. 按维度逐项检查 3. 标注严重程度（Critical / Warning / Suggestion） 4. 给出修复建议 ## 输出格式 ### [Critical] 问题标题 - 位置：文件:行号 - 描述：问题说明 - 建议：修复方案

内置技能一览

5.5 自定义斜杠命令

在.claude/commands/目录下创建.md文件，自动变成斜杠命令。

创建自定义命令

.claude/commands/review.md：

审查当前分支的所有变更，关注以下维度： 1. **安全性**：是否有敏感信息泄露、注入风险 2. **性能**：是否有 N+1 查询、不必要的计算 3. **可维护性**：函数是否过长、命名是否清晰 4. **测试覆盖**：变更是否有对应测试 输出格式： - 每个问题标注严重程度 [Critical/Warning/Suggestion] - 给出具体的修复建议 - 最后给出整体评分 (A/B/C/D)

.claude/commands/test-changed.md：

检测当前分支相对于 main 分支的变更文件， 为每个变更的源文件找到对应的测试文件， 运行所有相关测试，报告结果。 如果没有测试，建议应该添加哪些测试。

命令命名规则

• 项目命令前缀：/project:
• 个人命令前缀：/user:

带参数的命令

在命令文件中使用$ARGUMENTS占位符：

.claude/commands/explain.md：

详细解释以下代码的工作原理：$ARGUMENTS 要求： 1. 逐行解释关键逻辑 2. 画出执行流程图（用文字描述） 3. 指出潜在的边界情况 4. 给出优化建议

使用方式：

> /project:explain @src/auth.py:validate_token

5.6 MCP vs Skills vs Hooks 选择指南

组合使用示例

MCP（GitHub） + Skill（/review） + Hook（ESLint） → Claude 自动获取 PR → 按审查技能分析 → 编辑后自动 lint

5.7 小结

上一篇：04 进阶篇：权限、Hooks 与自动化
下一篇：06 高级篇：记忆系统与工作流优化