Claude MCP实战教程

89次阅读
没有评论

1. 简介

Claude MCP实战教程

Claude MCP,全称为“模型上下文协议”(Model Context Protocol),是由Anthropic公司为其Claude AI推出的一个开源协议。它的作用是让AI模型与开发环境之间能够更顺畅地沟通,就像给AI和开发工具之间架了一座桥。通过MCP,AI能够理解开发中的上下文信息,从而更好地帮助开发者处理代码和数据。

举个例子,借助Claude的桌面应用和MCP协议,AI可以帮你管理GitHub项目——从新建项目、编写代码,到提交Pull Request(代码变更请求),几乎一条龙操作,快速又高效。这个协议解决了以往大型语言模型(LLM)很难直接接入数据源的问题,不用再为每个数据系统单独开发集成代码,只要用MCP,一套方案就能搞定多种数据源的对接。

2. 应用场景

① 编程和代码管理

在编程过程中,开发者可以通过 MCP 协议,让 Claude 自动完成许多操作,比如写代码、创建代码仓库、上传代码(Push)、创建 Issue(问题追踪)、分支和 PR(Pull Request)等,全都在聊天界面里完成。你只要告诉它“我想实现什么功能”,剩下的交给 AI。这大大节省了重复性的工作,让程序员更专注于设计和思考。

② 数据管理和交互

管理本地资源

MCP协议还支持和本地文件、数据库(比如 SQLite)交互。你可以通过Claude来打开、编辑本地文件,或对数据库进行查询、更新等操作。关键是这些操作都可以在保证本地数据安全的前提下进行。

使用远程资源

MCP还可以接入云端平台,比如Google Drive、Slack等,这意味着Claude可以访问你存储在这些服务上的数据。企业或开发者可以方便地汇集来自各种系统和工具的数据,让AI更准确地生成响应或执行操作。

③ 构建智能助手

随着AI逐渐发展成像智能助手(Agent)那样能“做事”的工具,MCP让它不仅能回答问题,还能执行复杂任务,比如管理企业内部的文件、数据库、任务系统等。开发者可以用MCP把Claude接入各种业务系统,为企业打造一个真正“能干活”的AI助手。

3. 优点缺点

类别 编号 内容
优点 ① 简化数据连接 MCP最大的优势就是“省事”。过去,开发者需要为每种数据源写一套集成代码,现在只要集成一次MCP,后续无论是本地数据库还是远程服务(如GitHub、Slack),都能通用,大大节省开发工作量。
② 提高数据交互安全性 MCP使用的是标准协议,自带安全控制机制。比如,企业可以不用把API密钥交给Claude,而是通过 MCP服务器来“中转”数据,确保安全性。
③ 扩展AI能力 以前的AI只能问答,现在借助MCP,它能管理代码、编辑文件、操作数据库、调用外部工具,变成了一个真正能“动手”的智能工具。
④ 易于扩展 MCP支持像Prompts(提示模板)、Tools(工具集)、Sampling(抽样策略)等模块,让开发者可以按需扩展AI的功能,适配不同业务需求。
⑤ 支持多种数据格式 无论是文本文件、数据库数据、接口响应、图像截图还是日志文件,MCP都能处理,适用于各种类型的应用场景。
缺点 ① 面临行业标准竞争 目前市面上还有很多类似的数据连接协议,MCP只是其中之一,是否能成为“通用标准”还有待观察。
② 可能遇到兼容问题 尽管目标是“通用对接”,但一些老旧系统或特殊场景下,MCP可能还需要额外适配才能用。
③ 被质疑是“套壳工具” 有开发者认为,MCP本质上只是把已有技术组合在一起(如函数调用加代理服务器),并非一种真正创新的协议。
④ 部署范围有限 目前MCP需要部署在本地服务器上,暂时还不支持远程部署。这意味着它在多设备或企业级分布式应用中使用时,还存在一定限制。不过官方正计划开发更灵活的企业级版本。

4. 配置准备

4.1 安装Node.js

首先确保你已经安装了Node.js和npm(Node.js 安装包中已包含 npm),如果尚未安装,请访问Node.js 官网下载并安装最新的LTS版本。

安装后按下 Win + R 键,然后输入”cmd”或”powershell”打开命令提示符或PowerShell。

输入以下命令验证Node.js和npm是否正确安装。

node --version
npm --version

这两个命令应该显示已安装的版本号,Node.js版本要在v18以上。

Claude MCP实战教程
4.2 安装Claude桌面端
Claude MCP实战教程

首先,安装Claude应用软件,下载地址:https://claude.ai/download

Tips:昨日才用WildCard虚拟信用卡充了Claude Pro会员还有API,凌晨登录Claude桌面端,就显示封禁了,还好还有其余普通账号,MCP普通账号也可以配置。

5. 服务配置

5.1 本地文件系统(server-filesystem)

MCP中的@mcp/server-filesystem是一个用于文件系统管理的模块,主要用于处理服务器端与文件系统的交互。它可以独立或作为其他模块的依赖使用,提供标准化的文件存储、访问、读取、写入等能力。

Claude MCP实战教程

打开Claude桌面端软件,依次点击左上角File>Settings>Developers>Edit Config

Claude MCP实战教程

将创建”claude_desktop_config.json”配置文件,打开文件配置以下代码:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\Administrator\\Desktop",
        "C:\\Users\\Administrator\\Downloads"
      ]
    }
  }
}

“Administrator”是计算机名称,需与自己计算机名对应。

打开命令提示符,使用npx命令安装并运行包:

npx @modelcontextprotocol/server-filesystem
Claude MCP实战教程

输入以下命令:

npx @modelcontextprotocol/server-filesystem C:\Users\Administrator\Desktop
Claude MCP实战教程

看到 “Secure MCP Filesystem Server running on stdio” 消息,说明服务器已启动成功。

接着修改windows文件夹权限:

Claude MCP实战教程

① 右键点击下载文件夹,选择属性

② 进入安全选项卡,点击编辑按钮。

③ 确保Claude应用程序运行时使用的用户账户(这里是Administrator)有读取和列表权限。

④ 点击应用确定保存更改。

重启Claude应用软件,对话框右下角多出了一个小锤子的图标。

Claude MCP实战教程

点击图标发现可用的MCP工具有11个,里面有详细的介绍。

Claude MCP实战教程

翻译为中文这11个功能分别为:

create_directory
创建一个新目录或确保目录存在。可以一次性创建多个嵌套目录。如果目录已存在,此操作将悄无声息地成功。非常适合为项目设置目录结构或确保所需路径存在。仅在允许的目录内有效。

directory_tree
获取文件和目录的递归树状视图,以 JSON 结构呈现。每个条目包括“name”(名称)、“type”(类型:文件/目录)和“children”(对于目录)。文件没有子项数组,而目录总是有一个子项数组(可能为空)。输出格式为 2 个空格缩进,便于阅读。仅在允许的目录内有效。

edit_file
对文本文件进行基于行的编辑。每次编辑都会用新的内容替换精确的行序列。返回显示更改的 git 风格差异。仅在允许的目录内有效。

get_file_info
检索有关文件或目录的详细元数据。返回包括大小、创建时间、最后修改时间、权限和类型等全面信息。此工具非常适合了解文件的特征,而不需要读取实际内容。仅在允许的目录内有效。

list_allowed_directories
返回此服务器允许访问的目录列表。在访问文件之前使用此工具了解可用的目录。

list_directory
获取指定路径下所有文件和目录的详细列表。结果清晰地区分文件和目录,分别用 [FILE] 和 [DIR] 前缀标识。此工具对于理解目录结构和查找特定文件非常重要。仅在允许的目录内有效。

move_file
移动或重命名文件和目录。可以在不同目录之间移动文件并在单次操作中重命名。如果目标位置已存在,该操作将失败。可以跨目录操作,也可以在同一目录内进行简单重命名。源路径和目标路径必须都在允许的目录内有效。

read_file
读取文件系统中文件的完整内容。支持各种文本编码,并在文件无法读取时提供详细错误信息。当需要检查单个文件内容时使用此工具。仅在允许的目录内有效。

read_multiple_files  
同时读取多个文件的内容。当需要分析或比较多个文件时,比逐一读取更高效。每个文件的内容会以其路径作为引用返回。单个文件的读取失败不会阻止整个操作。仅在允许的目录内有效。

search_files  
递归搜索匹配模式的文件和目录。从起始路径开始,搜索所有子目录。搜索不区分大小写,并匹配部分名称。返回所有匹配项的完整路径。非常适合在不知道文件确切位置时查找文件。仅在允许的目录内有效。

write_file  
创建新文件或完全覆盖现有文件的内容。使用时请小心,因为它将覆盖现有文件而没有任何警告。支持文本内容的正确编码。仅在允许的目录内有效。

在Claude应用软件新建对话,输入以下指令:

访问本地系统,在下载文件夹创建一个lovess的文件夹,对话内容用中文输出
Claude MCP实战教程

Allow for This Chat一直允许。

Claude MCP实战教程

在对话中可用看见创建过程,创建完成后在下载文件夹中可用找到名为”lovess”的文件夹。

Claude MCP实战教程
正文完
 0
评论(没有评论)