MCP服务配置完全指南（超级详细）

最新推荐文章于 2025-05-01 09:38:25 发布

chuizi_cs

最新推荐文章于 2025-05-01 09:38:25 发布

阅读量3.2k

点赞数 58

文章标签：人工智能

本文链接：https://blog.csdn.net/chuizi_cs/article/details/146555962

版权

前言

Model Context Protocol (MCP) 是一种新兴的开放标准，用于扩展大型语言模型的能力。通过MCP，AI助手可以直接与外部工具、数据源和API进行交互，从而提供更加丰富和实用的服务。本文将详细介绍如何在Windows系统上配置MCP服务，包括服务端和客户端的设置。

调用成功的标志
调用成功的标注

MCP架构简介

MCP遵循客户端-服务器架构：

MCP服务器：提供特定功能（如天气查询、文件系统访问等）的独立程序
MCP客户端：内置于AI应用（如Cursor、Claude等）中，负责与服务器通信

为什么需要同时配置服务端和客户端？

这是一个常见的疑问：既然已经配置了MCP服务器，为什么还需要单独配置客户端？原因如下：

功能分离：服务器负责实现具体功能，而客户端负责与AI模型集成
安全隔离：客户端管理权限和访问控制，确保服务器只能在授权范围内操作
灵活组合：一个客户端可以连接多个服务器，实现功能组合
独立更新：服务端和客户端可以独立升级，不互相影响

简单来说，服务器是"能力提供者"，而客户端是"能力整合者"。两者缺一不可。

配置步骤

一、前期准备

安装Node.js

# 检查是否已安装
node --version
npm --version

# 如未安装，下载安装包：https://nodejs.org/

修改PowerShell执行策略（如需要）

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

二、安装MCP服务器

全局安装MCP服务包

npm install -g @modelcontextprotocol/server-sequential-thinking
# 或其他服务包，如
# npm install -g @modelcontextprotocol/server-filesystem
# npm install -g @modelcontextprotocol/server-brave-search

查找安装路径

npm root -g
# 例如：C:\Users\Username\AppData\Roaming\npm\node_modules

确定Node.js路径

where node
# 例如：C:\Program Files\nodejs\node.exe

三、配置MCP客户端（以Cursor为例）

打开Cursor设置
- 点击菜单 > Settings > Cursor Settings
- 找到并启用 MCP Servers 选项

添加MCP服务器

点击 “Add New MCP Server”
填写服务器名称（如 “Sequential Thinking”）
输入以下命令（选择一种）

方法一（推荐）：

cmd /c npx -y @modelcontextprotocol/server-sequential-thinking

方法二（如方法一失败）：

cmd /c node "C:\Users\Username\AppData\Roaming\npm\node_modules\@modelcontextprotocol\server-sequential-thinking\dist\index.js"

方法三（完整路径）：

"C:\Program Files\nodejs\node.exe" "C:\Users\Username\AppData\Roaming\npm\node_modules\@modelcontextprotocol\server-sequential-thinking\dist\index.js"

重启Cursor
- 完全关闭Cursor
- 重新打开Cursor

四、验证MCP服务

检查服务状态
- 打开Cursor的MCP Servers设置
- 查看服务器状态是否为绿色（正常）或黄色（部分功能可用）
测试MCP功能
- 在Composer或Agent模式下，尝试使用以下提示：
  - “请使用顺序思维方法分析这个问题”
  - “查看当前天气情况”（如果配置了天气服务）

实战案例：构建天气查询MCP服务器

本节将介绍如何创建一个实际的天气查询MCP服务器，以及如何配置和使用它。

1. 天气服务器需求分析

我们需要一个能够提供以下功能的天气查询服务：

获取特定州的天气警报
根据经纬度获取天气预报

2. 环境准备

首先，创建一个新的Python项目并安装必要的依赖：

# 创建项目目录
mkdir weather
cd weather

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# 或
.venv\Scripts\activate  # Windows

# 安装依赖
pip install mcp-fastmcp httpx

3. 编写天气服务器代码

创建一个名为 weather.py 的文件，代码如下：

from typing import Any
import httpx
from mcp.server.fastmcp import FastMCP

# 初始化FastMCP服务器
mcp = FastMCP("weather")

# 常量
NWS_API_BASE = "https://api.weather.gov"
USER_AGENT = "weather-app/1.0"

async def make_nw