意项
39.91M · 2026-03-23
MCP（Model Context Protocol，模型上下文协议）是 Anthropic 推出的开放标准协议，为 AI 应用提供了统一的方式来连接外部数据源和工具。你可以把 MCP 理解为 AI 世界的"USB-C 接口"——一个协议，即可让 AI 模型访问文件系统、数据库、搜索引擎等各类外部资源。本教程将带你在 Windows 系统上从概念到实战，全面掌握 MCP。
MCP 采用客户端-服务端架构，包含三个核心角色：
┌─────────────────────────────────────────┐
│ Host（Claude Desktop / CLI） │
│ │
│ ┌──────────┐ ┌──────────┐ │
│ │ Client A │ │ Client B │ ... │
│ └────┬─────┘ └────┬─────┘ │
└───────┼──────────────┼──────────────────┘
│ │
┌────▼─────┐ ┌────▼─────┐
│ Server A │ │ Server B │
│(filesystem)│ │(search) │
└──────────┘ └──────────┘
MCP 支持两种传输方式：
| 传输方式 | 说明 | 适用场景 |
|---|---|---|
| stdio | 通过标准输入/输出通信 | 本地 Server，最常用 |
| SSE | 通过 HTTP Server-Sent Events 通信 | 远程 Server，需网络访问 |
MCP Server 可以向 Host 暴露三种能力：
确保你的 Windows 系统已安装以下工具：
如果尚未安装，前往 nodejs.org 下载最新 LTS 版本。验证安装：
node --version
npm --version
部分 MCP Server 使用 Python 编写，需要通过 uvx 运行：
# 安装 uv（Python 包管理工具）
powershell -ExecutionPolicy ByPass -c "irm | iex"
安装完成后重新打开 PowerShell 验证：
uv --version
uvx --version
如果尚未安装 Claude CLI：
npm install -g @anthropic-ai/claude-code
Claude CLI 提供了命令行和配置文件两种方式来管理 MCP Server。
claude mcp add 命令# 添加 filesystem server
claude mcp add filesystem -s user -- npx -y @modelcontextprotocol/server-filesystem C:Users你的用户名Documents
参数说明：
| 参数 | 说明 |
|---|---|
filesystem | Server 名称（自定义，用于标识） |
-s user | 作用域：user（全局）或 project（当前项目） |
-- | 分隔符，之后的内容为 Server 启动命令 |
# 查看已配置的 MCP Server
claude mcp list
# 查看某个 Server 的详细信息
claude mcp get filesystem
# 移除某个 Server
claude mcp remove filesystem
Claude CLI 的 MCP 配置存储在 settings.json 中：
C:Users你的用户名.claudesettings.json项目根目录.claudesettings.json手动添加 MCP Server 示例：
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"C:\Users\你的用户名\Documents"
]
}
}
}
启动 Claude CLI 后，使用 /mcp 命令查看当前连接的 MCP Server 状态：
/mcp
输出中可以看到每个 Server 的名称、状态和提供的工具数量。
配置好 Filesystem Server 后，你可以直接让 Claude 操作项目文件：
> 读取 C:Users我projectsmyapppackage.json，列出所有依赖的版本
> 在 C:Users我Documentsnotes 目录下创建一个 todo.md，内容是本周的工作计划
> 找出 src 目录下所有包含 "TODO" 注释的文件
配置好 Brave Search Server 后，Claude 具备了实时联网能力：
> 搜索 2026 年最新的 React 状态管理方案对比
> 搜索 Windows 11 最新的 PowerShell 更新内容
配置好 GitHub Server 后，可以直接通过对话管理仓库：
> 列出我的 GitHub 仓库中所有 open 状态的 issue
> 为 myapp 仓库创建一个新的 issue，标题是"优化首页加载速度"
> 查看 myapp 仓库最近的 5 个 pull request
MCP 的强大之处在于多个 Server 可以协同工作：
> 搜索最新的 Tailwind CSS v4 变更内容，然后帮我更新项目中的 tailwind.config.ts 文件
这条指令中，Claude 会先调用 Brave Search 搜索信息，再调用 Filesystem 读取并修改文件。
如果现有的 MCP Server 不能满足需求，你可以用 TypeScript SDK 快速开发自己的 Server。
mkdir my-mcp-server
cd my-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk zod
npm install -D typescript @types/node
npx tsc --init
创建 src/index.ts：
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';
// 创建 MCP Server 实例
const server = new McpServer({
name: 'my-weather-server',
version: '1.0.0',
});
// 注册一个 Tool：查询天气
server.tool(
'get-weather',
'获取指定城市的天气信息',
{
city: z.string().trim().min(1, '城市名称不能为空').describe('城市名称，例如：北京'),
},
async ({ city }) => {
// 使用心知天气 API 获取实时天气
const SENIVERSE_API_KEY = 'YOUR_API_KEY_HERE';
const weatherResp = await fetch(
`${encodeURIComponent(SENIVERSE_API_KEY)}&location=${encodeURIComponent(city)}&language=zh-Hans&unit=c`,
);
if (!weatherResp.ok) {
throw new Error(`心知天气查询失败: HTTP ${weatherResp.status}`);
}
const weatherJson = (await weatherResp.json()) as {
results?: Array<{
location?: { name?: string };
now?: { text?: string; temperature?: string; humidity?: string };
}>;
};
const result = weatherJson.results?.[0];
const now = result?.now;
if (!result || !now) {
throw new Error(`未找到城市或天气数据: ${city}`);
}
const weatherData = {
city: result.location?.name ?? city,
temperature: now.temperature !== undefined ? `${now.temperature}°C` : 'N/A',
condition: now.text ?? 'N/A',
humidity: now.humidity !== undefined ? `${now.humidity}%` : 'N/A',
};
return {
content: [
{
type: 'text' as const,
text: JSON.stringify(weatherData, null, 2),
},
],
};
},
);
// 启动 Server（使用 stdio 传输）
async function main(): Promise<void> {
const transport = new StdioServerTransport();
await server.connect(transport);
console.error('Weather MCP Server is running');
}
main().catch(console.error);
修改 tsconfig.json，确保以下配置：
{
"compilerOptions": {
"target": "ES2022",
"module": "Node16",
"moduleResolution": "Node16",
"outDir": "./dist",
"rootDir": "./src",
"strict": true,
"esModuleInterop": true
},
"include": ["src/**/*"]
}
编译项目：
npx tsc
claude mcp add my-weather -s user -- node C:Users你的用户名my-mcp-serverdistindex.js
重启 Claude Desktop 或 Claude CLI 后，就可以使用了：
> 查询北京的天气
Claude 会调用你的 get-weather 工具并返回结果。
Q: Server 启动报错 npx 不是内部或外部命令？
Node.js 未正确安装或 PATH 未配置。在 PowerShell 中验证：
where.exe npx
# 应输出 npx 的完整路径
如果无输出，重新安装 Node.js 并确保勾选"Add to PATH"选项。
Q: Server 启动报错 uvx 不是内部或外部命令？
需要安装 uv 工具。参考"环境准备"章节中的安装步骤。
Q: 配置了 env 中的 API Key 但仍然报认证失败？
Q: Claude CLI 中 /mcp 显示 Server 状态为 disconnected？
尝试以下步骤：
# 查看 Server 详细信息
claude mcp get <server-name>
# 移除并重新添加
claude mcp remove <server-name>
claude mcp add <server-name> -s user -- <command> <args>
MCP 为 AI 应用提供了标准化的外部集成方式，让 Claude 从一个"只能对话"的模型变成了能够操作文件、搜索网络、管理代码仓库的全能助手。通过本教程，你已经掌握了：
推荐资源：
