Chennl's Profile
MCPClaude使用教程

Claude 官方 MCP 使用教程

以官方 Filesystem MCP Server 为例,演示文件读写能力,并完整说明 Node.js、客户端和服务配置流程。

这个MCP服务是来自官方Claude的Filesystem MCP Server,非常简单好上手,而且功能非常实用,我认为每个刚了解MCP的朋友都可以先从这个简单的MCP去理解使用原理。

它允许AI助手(如Claude)安全地访问你计算机上的文件和目录,执行读取、写入、搜索等操作,同时确保只能访问你明确允许的目录。

主要功能

  • 读取/写入文件

  • 创建/列出/删除目录

  • 移动文件/目录

  • 搜索文件

  • 获取文件元数据

MCP 服务功能演示

假设我想在AI的协助下写一篇文章,然后直接帮我保存到本地。

  • 首先让AI帮我创作文章

  • 告诉AI帮我新建文件夹,并保存为Word文档

  • 前往AI帮我新建的文件夹“文章写作”

  • 打开生成的Word文档,查看文章内容

安装和配置指南

前提条件

在安装MCP文件系统服务之前,你需要确保你的计算机上已安装以下软件:

  1. Node.js:MCP文件系统服务是基于Node.js构建的

  2. MCP客户端:与AI助手交互的应用程序,用于连接MCP服务

如果你没有安装这些软件,请按照以下步骤进行安装:

安装Node.js

  1. 访问 Node.js官网

  2. 下载并安装适合你操作系统的LTS(长期支持)版本

  3. 安装完成后,打开终端(命令行)并输入 node -v 确认安装成功

安装MCP客户端

  1. 这里推荐使用 Cherry Studio

  2. 下载并安装适合你操作系统的MCP客户端版本

配置MCP服务

  1. 打开Cherry Studio

  2. 点击左下角的设置图标-选择MCP服务器

  3. 点击「添加服务器」,并在配置页面中填写以下内容:

配置成功后,页面下方会显示约10个可用工具的描述,你可以根据这些描述去使用。如果看不懂的话,根据我后边整理的使用场景进行日常使用也够了!

在Cherry Studio上使用 MCP 服务

在对话页面的底部点击「MCP服务器」图标,☑️勾选我们刚保存运行的MCP服务

然后我们就可以跟AI对话,让AI帮我们读写、整理、搜索电脑文件啦~

使用场景与示例

配置成功后,MCP客户端就可以访问你指定的文件和目录了。以下是一些常见使用场景和示例:

读取文件

可以读取指定目录中的文件内容。

用户:请读取我的文档目录中的"项目计划.txt"文件  

AI助手:我会帮你读取该文件。让我查看一下...
[AI助手读取文件后显示内容]

写入文件

可以创建新文件或修改现有文件。

用户:请在我的文档目录中创建一个名为"会议记录.txt"的文件,内容是今天的会议要点

AI助手:好的,我会创建这个文件。请告诉我你希望包含哪些会议要点?

用户:[提供会议要点]

AI助手:谢谢你提供的信息。我已经创建了"会议记录.txt"文件,并写入了你提供的会议要点。

列出目录内容

可以列出指定目录中的所有文件和子目录。

用户:请列出我的项目目录中的所有文件和文件夹

AI助手:好的,我会列出你项目目录中的内容。让我查看一下...
[AI助手列出目录内容,区分文件和文件夹]

搜索文件

可以在指定目录中搜索特定文件。

用户:请在我的文档目录中搜索所有包含"预算"的文件

AI助手:好的,我会在你的文档目录中搜索包含"预算"的文件。让我查找一下...
[AI助手显示搜索结果]

获取文件信息

可以获取特定文件的详细信息。

用户:请告诉我"项目报告.docx"文件的大小和最后修改时间

AI助手:好的,我会查看该文件的信息。让我检查一下...
[AI助手显示文件大小和修改时间等信息]

创建目录

可以创建新的目录结构。

用户:请在我的项目目录中创建一个名为"新项目"的文件夹,并在其中创建"文档"、"源代码"和"资源"三个子文件夹
AI助手:好的,我会创建这些目录。让我开始操作...
[AI助手创建目录结构并确认完成]

移动文件

可以移动或重命名文件。

用户:请将"旧报告.txt"重命名为"最终报告.txt"

AI助手:好的,我会重命名该文件。让我操作一下...
[AI助手重命名文件并确认完成]

编辑文件

可以对文件进行特定的编辑。

用户:请打开"联系人.txt"文件,将其中的"旧电话号码"更改为"新电话号码"

AI助手:好的,我会编辑该文件。让我先查看当前内容...
[AI助手显示文件内容,然后进行编辑并确认完成]

结合日常使用场景示例

以下是一些具体的日常使用场景,展示文件系统MCP服务如何帮助你完成各种任务:

场景一:整理照片文件

使用场景:你有一个包含数百张照片的文件夹,需要按日期或主题整理。

用户:我的"照片"文件夹中有很多照片文件,请帮我查看一下有哪些文件。

AI助手:好的,我来查看你照片文件夹中的内容。
[AI助手列出照片文件夹中的所有文件]

用户:请帮我在这个文件夹中创建"家庭"、"旅行"和"工作"三个子文件夹,然后帮我将照片按名称分类移动到相应文件夹。

AI助手:好的,我会创建这些文件夹并帮你整理照片。
[AI助手创建文件夹并移动文件,然后报告完成情况]

用户:请帮我查看一下现在各个文件夹中有多少张照片。

AI助手:好的,让我统计一下每个文件夹中的照片数量。
[AI助手提供每个文件夹的照片数量统计]

场景二:管理学习笔记

使用场景:你正在学习一门课程,需要整理和更新笔记文件。

用户:我的"学习笔记"文件夹中有多个课程的笔记,请帮我查看一下。
AI助手:好的,我来查看你的学习笔记文件夹。
[AI助手列出学习笔记文件夹中的内容]

用户:请打开"数据分析.md"文件,帮我在文件末尾添加今天的学习内容:数据可视化技巧和常用图表类型。
AI助手:好的,我会打开文件并添加这些内容。
[AI助手打开文件,添加内容并确认完成]

用户:现在请帮我创建一个新的笔记文件"学习计划.md",列出未来两周的学习目标。
AI助手:好的,我会创建这个新文件。你希望包含哪些学习目标?
[用户提供学习目标,AI助手创建文件并确认]

场景三:项目文档管理

使用场景:你正在管理一个项目,需要组织和更新项目文档。

用户:我的"项目文档"文件夹中有我正在进行的项目资料,请帮我查看一下文件结构。
AI助手:好的,我来查看你的项目文档文件夹结构。
[AI助手显示项目文档的文件夹结构]

用户:请在"会议记录"文件夹中创建一个新文件"2025-05-13会议纪要.txt",记录今天的会议内容。
AI助手:好的,我会创建这个会议纪要文件。请告诉我需要记录的会议内容。
[用户提供会议内容,AI助手创建文件并确认]

用户:现在请帮我更新"项目进度.md"文件,将第三阶段的完成度从60%更新为85%。
AI助手:好的,我会更新项目进度文件。
[AI助手更新文件并确认完成]

场景四:代码项目管理

使用场景:你正在开发一个软件项目,需要管理代码文件和配置。

用户:请帮我查看"web项目"文件夹中的文件结构。
AI助手:好的,我来查看你的web项目文件夹结构。
[AI助手显示web项目的文件结构]

用户:请帮我在"src/components"目录下创建一个新的React组件文件"Button.js"。
AI助手:好的,我会创建这个React组件文件。你希望这个Button组件包含哪些功能?
[用户描述组件功能,AI助手创建文件并确认]

用户:现在请帮我在"config.json"文件中将API端点从"http://api.example.com/v1"更新为"http://api.example.com/v2"。
AI助手:好的,我会更新配置文件中的API端点。
[AI助手更新文件并确认完成]

场景五:文本文件批量处理

使用场景:你有多个文本文件需要进行相同的修改或格式调整。

用户:我的"报告"文件夹中有多个月度报告文件,请帮我查看一下。
AI助手:好的,我来查看你的报告文件夹。
[AI助手列出报告文件夹中的文件]

用户:请帮我搜索所有报告文件中包含"销售额"的内容,并告诉我每个月的销售额数据。
AI助手:好的,我会搜索这些信息。
[AI助手搜索并整理销售额数据]

用户:现在请帮我在所有报告文件的开头添加一行标准免责声明:"本报告仅供内部使用,请勿外传。"
AI助手:好的,我会在所有报告文件中添加这行免责声明。
[AI助手修改所有文件并确认完成]

场景六:个人财务管理

使用场景:你使用电子表格管理个人财务,需要更新和分析数据。

用户:请帮我查看"个人财务"文件夹中的文件。
AI助手:好的,我来查看你的个人财务文件夹。
[AI助手列出个人财务文件夹中的文件]

用户:请打开"2025年支出跟踪.csv"文件,帮我添加今天的几笔支出:午餐45元,交通20元,书籍98元。
AI助手:好的,我会打开文件并添加这些支出记录。
[AI助手更新文件并确认完成]

用户:现在请帮我分析一下本月的支出类别分布,告诉我哪类支出最多。
AI助手:好的,我会分析你的支出数据。
[AI助手分析数据并提供支出分布报告]

场景七:学术论文写作

使用场景:你正在撰写学术论文,需要管理参考文献和论文章节。

用户:请帮我查看"论文"文件夹中的内容。  
AI助手:好的,我来查看你的论文文件夹。
[AI助手列出论文文件夹中的内容]

用户:请打开"参考文献.bib"文件,帮我添加一篇新的参考文献。
AI助手:好的,我会打开参考文献文件。请提供你要添加的参考文献信息。
[用户提供参考文献信息,AI助手更新文件并确认]

用户:现在请帮我在"论文正文.tex"文件中的"相关工作"章节后添加一个新的章节"研究方法"。
AI助手:好的,我会在论文文件中添加新章节。
[AI助手更新文件并确认完成]

场景八:网站内容管理

使用场景:你正在维护一个静态网站,需要更新网页内容和资源。

用户:请帮我查看"网站"文件夹中的文件结构。
AI助手:好的,我来查看你的网站文件夹结构。
[AI助手显示网站的文件结构]

用户:请打开"index.html"文件,帮我更新页面标题和首页的公告信息。
AI助手:好的,我会打开index.html文件。你希望将标题和公告更新为什么内容?
[用户提供新内容,AI助手更新文件并确认]

用户:现在请帮我在"css/style.css"文件中修改主题颜色,将#336699改为#3366CC。
AI助手:好的,我会更新CSS文件中的颜色代码。
[AI助手更新文件并确认完成]

结语

通过MCP服务,你可以轻松实现AI助手与本地文件的交互,大幅提升工作效率。无论是文档管理、代码编写还是数据处理,AI都能成为你的得力助手。如果你在使用过程中遇到任何问题,或者有特别的使用场景想探讨,欢迎随时留言交流!

文章目录6 个章节