问小白 wenxiaobai
资讯
历史
科技
环境与自然
成长
游戏
财经
文学与艺术
美食
健康
家居
文化
情感
汽车
三农
军事
旅行
运动
教育
生活
星座命理

使用MCP协议连接本地和远程数据——以Claude的Windows客户端为例

创作时间:
作者:
@小白创作中心

使用MCP协议连接本地和远程数据——以Claude的Windows客户端为例

引用
CSDN
1.
https://blog.csdn.net/Gltu_java/article/details/144608271

本文将详细介绍如何在Windows系统上配置Claude客户端的MCP服务器,使Claude能够访问外部数据和工具,打破“数据孤岛”问题。

为什么选择 MCP?

MCP 可帮助您在 LLM 之上构建代理和复杂的工作流程。LLM 经常需要与数据和工具集成,而 MCP 提供:

  • 越来越多的预构建集成,您的 LLM 可以直接插入
  • 在 LLM 提供商和供应商之间切换的灵活性
  • 在基础架构中保护数据的最佳实践

MCP协议

MCP是什么?这里我们先不做定义,先提出一个问题,如果我问Claude获取当前北京时间,它会怎么回复?

这里可以看到claude明确表示没有获取实时时间的功能,但是通过MCP协议,就可以打破“数据孤岛”问题,让 AI 在访问外部资源时不再受限,效果如下:

只需要地区或者时区就能获取实时时间,非常的有趣

环境准备

  1. 安装 Claude Desktop App
  • 目前客户端仅支持Windows和Mac系统:Download - Claude
  1. 安装Node.js(v18.x或更高版本)
  • 下载地址:Node.js — Run JavaScript Everywhere
  1. 安装Python 3.10或更高版本(直接下载指定版本python或者使用Conda创建指定版本环境均可)
  • 下载地址:Download Python | Python.org
  • 安装时请确保勾选"Add Python to PATH"选项

安装步骤

1. 安装包管理器

这里我们安装 uv(Python 包管理器和虚拟环境工具),SQLite(轻量级的关系型数据库管理系统),Git (版本控制系统)

以管理员身份打开PowerShell并运行以下两条命令:

winget install --id=astral-sh.uv -e
winget install git.git sqlite.sqlite

上述安装也可以使用npm安装:

# 用于基于Python的服务器
npm install -g uv

2. 安装MCP服务器

基于Node.js的服务器:

# 全局安装服务器
npm install -g @modelcontextprotocol/server-memory
npm install -g @modelcontextprotocol/server-everything
npm install -g @modelcontextprotocol/server-brave-search
# ...安装其他你需要的服务器

基于Python的服务器:

# 使用uvx
uvx mcp-server-sqlite

3. 创建Claude配置文件

  1. 进入目录:
    %AppData%\Claude\
  2. 创建并使用记事本或者json工具编辑
    claude_desktop_config.json
  3. 你可以打开运行
    Win+R
    ,然后直接输入
    %APPDATA%/Claude/claude_desktop_config.json
  4. 使用以下配置结构:
{
  "globalShortcut": "Ctrl+Space",
  "mcpServers": {
    "sqlite": {
      "command": "uvx",
      "args": ["mcp-server-sqlite", "--db-path", "C:\\Users\\你的用户名\\test.db"]
    },
    "memory": {
      "command": "node",
      "args": ["C:\\Users\\你的用户名\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-memory\\dist\\index.js"],
      "env": {
        "DEBUG": "*"
      }
    },
    "everything": {
      "command": "node",
      "args": ["C:\\Users\\你的用户名\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-everything\\dist\\index.js"],
      "env": {
        "DEBUG": "*"
      }
    },
    "brave-search": {
      "command": "node",
      "args": ["C:\\Users\\你的用户名\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-brave-search\\dist\\index.js"],
      "env": {
        "BRAVE_API_KEY": "你的API密钥",
        "DEBUG": "*"
      }
    }
  }
}

重要提示:


  • 你的用户名
    替换为你的Windows用户名

  • 你的API密钥
    替换为需要API密钥的服务的实际密钥
  • Windows路径中使用双反斜杠()
  • 路径要指向npm模块目录中的
    dist/index.js
    文件

特定服务器设置

SQLite服务器

  • 仅需要上述基本设置
  • 可以自定义
    --db-path
    参数指向你偏好的位置

Memory服务器

  • 无需额外设置
  • 默认启用调试日志

Everything服务器

  • 无需额外设置
  • 默认启用调试日志

Brave搜索服务器

  1. 从Brave Search API | Brave 获取API密钥
  2. 如上所示将其添加到配置的env部分

验证和故障排除

验证安装

# 列出已安装的包
npm list -g --depth=0
# 测试各个服务器
npx @modelcontextprotocol/server-memory
npx @modelcontextprotocol/server-brave-search
uvx mcp-server-sqlite

常见问题

  1. “无法连接到MCP服务器”
  • 确认配置中的路径与你的系统匹配
  • 确保所有包都已全局安装(使用-g标志)
  • 检查指定路径中是否存在dist/index.js
  1. 服务器未在Claude中显示
  • 重启Claude Desktop
  • 验证配置文件的JSON语法
  • 检查文件路径是否正确
  • 始终使用全局安装(
    npm install -g
  • 在配置中使用
    dist/index.js
    的完整路径
  • 保留DEBUG环境变量以便故障排除
  • 更改配置后杀掉进程重启Claude Desktop

成功开启后,Claude会有下图的新的icon:

本次实践使用的
claude_desktop_config.json
内容如下(获取实时时间):

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time",
        "--local-timezone=Asia/Shanghai"
      ]
    }
  }
}

常用的MCP服务器工具

MCP服务器
功能
GitHub
代码仓库管理、Git操作、API集成
Filesystem
访问本地文件系统,读取/写入文件
SQLite
与SQLite数据库的交互
Brave Search
网络搜索、获取实时信息
Google Maps
位置服务、路线规划、地点详情
Puppeteer
浏览器自动化和爬虫程序

参考博客:

  • MCP协议详解:如何使用Claude连接本地和远程数据,轻松管理一切!
  • 如何在windows电脑上开启Claude MCP Server - Blog - Playground
  • 如何设置 Github MCP 服务器以与 Windows 和 Mac 上的 Claude Desktop 一起使用
  • <工具 Claude Desktop> 配置 MCP server 连接本地 SQLite, 本机文件夹(目录) 网络驱动器 Windows 11 系统-CSDN博客
  • MCP开源地址:modelcontextprotocol/servers: Model Context Protocol Servers
  • MCP文档地址:Introduction - Model Context Protocol
© 2023 北京元石科技有限公司 ◎ 京公网安备 11010802042949号