id: 14a3cc862b124e73925539f0570fc4e9
parent_id: 
item_type: 1
item_id: 942bc42b0f1048b384d9077b519c4740
item_updated_time: 1764345628023
title_diff: "[{\"diffs\":[[1,\"CherryStudio配置本地MCP服务器实现FileSystem本地文件系统读写操作\"]],\"start1\":0,\"start2\":0,\"length1\":0,\"length2\":44}]"
body_diff: "[{\"diffs\":[[1,\"<html>\\\r\\\n<head>\\\r\\\n  <title>CherryStudio配置本地MCP服务器实现FileSystem本地文件系统读写操作</title>\\\r\\\n  <basefont face=\\\"微软雅黑\\\" size=\\\"2\\\" />\\\r\\\n  <meta http-equiv=\\\"Content-Type\\\" content=\\\"text/html;charset=utf-8\\\" />\\\r\\\n  <meta name=\\\"exporter-version\\\" content=\\\"YXBJ Windows/608924 (zh-CN, DDL); Windows/10.0.0 (Win64); EDAMVersion=V2;\\\"/>\\\r\\\n  <meta name=\\\"content-class\\\" content=\\\"yinxiang.peso.superNote\\\"/>\\\r\\\n  <meta name=\\\"application-data:yinxiang.noteLayout\\\" content=\\\"{\\\"lineSpace\\\":\\\"recommend\\\",\\\"paragraphSpace\\\":\\\"recommend\\\"}\\\"/>\\\r\\\n  <style>\\\r\\\n\\tbody, td {\\\r\\\n\\t  font-family: 微软雅黑;\\\r\\\n\\t  font-size: 12pt;\\\r\\\n\\t}\\\r\\\n  </style>\\\r\\\n</head>\\\r\\\n<body>\\\r\\\n<a name=\\\"40217\\\"></a>\\\r\\\n<h1>CherryStudio配置本地MCP服务器实现FileSystem本地文件系统读写操作</h1>\\\r\\\n\\\r\\\n<div><span style=\\\"\\\"><div style=\\\"max-width: 700px;\\\"><p></p><div style=\\\"--en-blockquote: true; box-sizing: border-box; border-left: 3px solid #b4c0cc; background-position: initial initial; background-repeat: initial initial;\\\"><div>原文链接: <a href=\\\"http://mp.weixin.qq.com/s?__biz=Mzg2NzA1MjIwNg==&amp;mid=2247483859&amp;idx=1&amp;sn=f035418b652abfa8efef0528d3a46080&amp;chksm=cfed7042a5b390a57031e868a50ce9b231fd98c6dbad6289a2d6f282f2d95dbfbdea0e248ff6&amp;mpshare=1&amp;scene=1&amp;srcid=0420tgwqcAq7637tMDg2NMkx&amp;sharer_shareinfo=7e22be782c463c308e16d82950825b1d&amp;sharer_shareinfo_first=7e22be782c463c308e16d82950825b1d#rd\\\"><span>http://mp.weixin.qq.com/s?__biz=Mzg2NzA1MjIwNg==&amp;mid=2247483...</span></a></div></div><p></p><div style=\\\"\\\"><div><div><div><span style=\\\"\\\">原创</span><span><span style=\\\"\\\">略懂架构的老C</span></span><span><a style=\\\"\\\"> 架构面面观 </a></span><span><em></em></span></div><div style=\\\"\\\"><p style=\\\"\\\"><span>以下是为Cherry Studio内置的MCP服务器添加FileSystem文件系统MCP组件的详细步骤：</span></p><p style=\\\"\\\"><span><span style=\\\"font-size: 24px; font-weight: bold;\\\">步骤1：安装UV和Bun工具</span></span></p><p style=\\\"\\\"><span>FileSystem文件系统操作MCP组件的运行依赖UV和Bun工具，需先确保它们已正确安装：</span></p><div style=\\\"text-align: center;\\\"><img src=\\\":/3880c351022548a4a8b567b78d31f90e\\\" type=\\\"image/png\\\" data-filename=\\\"640.png\\\" style=\\\"--en-marks: %7B%22align%22%3A%22center%22%7D; width: auto;\\\" width=\\\"auto\\\"/></div><p style=\\\"\\\"><span><span style=\\\"font-size: 20px; font-weight: bold; text-decoration: underline;\\\">1. 自动安装（推荐）：</span></span></p><ul style=\\\"list-style-type: circle;\\\"><li><p style=\\\"\\\"><span>打开Cherry Studio，进入【</span><span>设置】 → 【</span><span>MCP服务器】。</span></p></li><li><p style=\\\"\\\"><span>点击 【</span><span>安装】 按钮，工具会自动下载并安装到以下路径：</span></p></li></ul><ul style=\\\"list-style-type: disc;\\\"><li style=\\\"\\\"><p style=\\\"\\\"><span><span style=\\\"\\\">Windows: “</span></span><span><span style=\\\"\\\">C:\\\\Users\\\\&lt;用户名&gt;\\\\.cherrystudio\\\\bin”</span></span></p></li><li style=\\\"\\\"><p style=\\\"\\\"><span><span style=\\\"\\\">macOS/Linux: “</span></span><span><span style=\\\"\\\">\\\\~/.cherrystudio/bin”。</span></span></p></li></ul><p style=\\\"\\\"><span><span style=\\\"font-size: 20px; font-weight: bold; text-decoration: underline;\\\">2.手工安装（必需）：</span></span></p><p style=\\\"\\\"><span>若安装失败（如提示找不到“</span><span>uvx”或“</span><span>bun”），需手动从GitHub下载UV和Bun的可执行文件，并放入上述目录。</span></p><p style=\\\"\\\"><span>我自己的经验来说，截止目前v1.2.4版本的CherryStudio，在启用内置的“MCP服务器”时，无论是能或者不能直连GitHub下载UV和Bun工具，就算显示安装成功，我去对应文件夹下看过，仍然是没有的，这就是谎报。</span></p><div style=\\\"text-align: center;\\\"><img src=\\\":/43ff3038dafe438e9a78589c01011b50\\\" type=\\\"image/png\\\" data-filename=\\\"640.png\\\" style=\\\"--en-marks: %7B%22align%22%3A%22center%22%7D; width: auto;\\\" width=\\\"auto\\\"/></div><div><span>所以还是老老实实手工下载对应工具包到对应目录吧。</span></div><div style=\\\"text-align: center;\\\"><img src=\\\":/b9be1a10805a4601ad3492ce21cd9fe8\\\" type=\\\"image/png\\\" data-filename=\\\"640.png\\\" style=\\\"--en-marks: %7B%22align%22%3A%22center%22%7D; width: auto;\\\" width=\\\"auto\\\"/></div><div><span>当然，考虑到国内的网络现状，并且GitHub在4月中旬还封禁了所有中国IP访问，幸好我都已经把bun和uvx这两个包都存放在本地，大家如有需要，可以关注本公众号后，发消息【</span><span><span style=\\\"text-decoration: underline;\\\">mcp-filesystem</span>】，以获取国内可用下载链接。</span></div><p style=\\\"\\\"><span><span style=\\\"font-size: 24px; font-weight: bold;\\\">步骤2：添加FileSystem MCP服务器</span></span></p><p style=\\\"\\\"><span><span style=\\\"font-size: 20px; font-weight: bold; text-decoration: underline;\\\">1. 进入MCP服务器配置界面：</span></span></p><p style=\\\"\\\"><span>在Cherry Studio中，点击 “</span><span>设置” → “</span><span>MCP服务器” → “</span><span>添加服务器”。</span></p><p style=\\\"\\\"><span><span style=\\\"font-size: 20px; font-weight: bold; text-decoration: underline;\\\">2.通过搜索MCP进行在线安装：</span></span></p><p style=\\\"\\\"><span>下面是直接在CherryStudio里“MCP服务器”页面顶部点击“搜索MCP”。</span></p><div style=\\\"text-align: center;\\\"><img src=\\\":/55e960b16ffa4cdca89d1545ee765719\\\" type=\\\"image/png\\\" data-filename=\\\"640.png\\\" style=\\\"--en-marks: %7B%22align%22%3A%22center%22%7D; width: auto;\\\" width=\\\"auto\\\"/></div><p style=\\\"\\\"><span>在“搜索MCP”页面里面找到想要的MCP服务，点“+”号添加即可：</span></p><div style=\\\"text-align: center;\\\"><img src=\\\":/c4b403daf10d4b5399cbb2a3f6f4aef9\\\" type=\\\"image/png\\\" data-filename=\\\"640.png\\\" style=\\\"--en-marks: %7B%22align%22%3A%22center%22%7D; width: auto;\\\" width=\\\"auto\\\"/></div><p style=\\\"\\\"><span>在搜索框中列举了几家出品MCP服务的分发机构，例如：@cherry；@modelcontextprotocol；@gongrzhe；@mcpmarket这几家，当然cherry应该就是CherryStudio开发商自己搞的，看名字modelcontextprotocol像是哪家MCP官方搞的，还有mcp.so等MCP市场。</span></p><p style=\\\"\\\"><span>添加成功后，记得要对“@cherry/filesystem”添加一下配置：</span></p><div style=\\\"text-align: center;\\\"><img src=\\\":/837c44cdaa2d418ea45947a8e3ca22b1\\\" type=\\\"image/png\\\" data-filename=\\\"640.png\\\" style=\\\"--en-marks: %7B%22align%22%3A%22center%22%7D; width: auto;\\\" width=\\\"auto\\\"/></div><p style=\\\"\\\"><span>主要是为“@cherry/filesystem”MCP服务器在“参数”添加可操作的本机文件操作路径：“D:\\\\mcp_on_t11pro”；而且从CherryStudio v1.2.4版本起已经不像网上说的那样“配置Windows的文件系统路径时，必须把单反斜杠（\\\\）替换为双反斜杠（\\\\\\\\）”，目前已经不需要这样了，按正常的路径写即可。</span></p><p style=\\\"\\\"><span><span style=\\\"font-size: 24px; font-weight: bold;\\\">步骤3：验证与使用</span></span></p><p style=\\\"\\\"><span><span style=\\\"font-size: 20px; font-weight: bold; text-decoration: underline;\\\">1. 保存配置：</span></span></p><p style=\\\"\\\"><span>点击 “</span><span>确定” 保存服务器配置，重启Cherry Studio使配置生效 。</span></p><p style=\\\"\\\"><span><span style=\\\"font-size: 20px; font-weight: bold; text-decoration: underline;\\\">2. 启用MCP服务：</span></span></p><p style=\\\"\\\"><span>在聊天界面中，选择支持函数调用的模型（模型名称旁有扳手图标）。</span></p><p style=\\\"\\\"><span>点击输入框下方的 “</span><span>MCP服务器”，勾选已添加的“</span><span>@ferry/filesystem”服务。</span></p><p style=\\\"\\\"><span><span style=\\\"font-size: 20px; font-weight: bold; text-decoration: underline;\\\">3. 测试功能：</span></span></p><p style=\\\"\\\"><span>输入指令测试文件操作，例如：</span></p><p style=\\\"\\\"><span>“</span><span>使用@cherry/filesystem读取“d:\\\\mcp_on_t11pro\\\\\nongye.txt”文件的内容，并显示”</span></p><p style=\\\"\\\"><span>成功返回文件内容，配置完成。</span></p><div style=\\\"text-align: center;\\\"><img src=\\\":/17290de8419d41578b10f912fe09a8fd\\\" type=\\\"image/png\\\" data-filename=\\\"640.png\\\" style=\\\"--en-marks: %7B%22align%22%3A%22center%22%7D; width: auto;\\\" width=\\\"auto\\\"/></div><div><span>最后，我们再从CherryStudio的MCP服务器页面打开“@cherry/filesystem”组件的“工具”项，这里列出了该文件系统工具所能实现的功能：</span></div><div style=\\\"text-align: center;\\\"><img src=\\\":/c506b9eab9294aada96288663072fa5d\\\" type=\\\"image/png\\\" data-filename=\\\"640.png\\\" style=\\\"--en-marks: %7B%22align%22%3A%22center%22%7D; width: auto;\\\" width=\\\"auto\\\"/></div><p style=\\\"\\\"><span>“@cherry/filesystem”组件的功能主要包含以下几个方面:</span></p><p style=\\\"\\\"><span>注意：以下所有权限都是该MCP组件针对指定目录（含子目录及文件）及目录下的文件的；file指文件，directory指目录（文件夹）。</span></p><ul style=\\\"list-style-type: square;\\\"><li><p style=\\\"\\\"><span>对文件的“读”权限</span></p></li><li><p style=\\\"\\\"><span>对文件的“写”权限（创建文件）</span></p></li><li><p style=\\\"\\\"><span>对文件的“编辑”权限</span></p></li><li><p style=\\\"\\\"><span>对目录的“创建”权限</span></p></li><li><p style=\\\"\\\"><span>对目录的“读取并列出”权限</span></p></li><li><p style=\\\"\\\"><span>对文件的“移动”权限</span></p></li><li><p style=\\\"\\\"><span>对文件的“搜索”权限</span></p></li><li><p style=\\\"\\\"><span>对文件的“获取属性”权限</span></p></li></ul><p style=\\\"\\\"><span>其中恰恰没有对文件、目录的“删除”权限，也说明CherryStudio官方对“@cherry/filesystem”组件的慎重，担心其误删除用户的本地文件导致数据丢失灾难的问题。这其实也是对用户使用MCP等新技术的一种保护，值得表扬。</span></p></div></div></div></div></div></span>\\\n</div></body></html>\\u0000\"]],\"start1\":0,\"start2\":0,\"length1\":0,\"length2\":7660}]"
metadata_diff: {"new":{"id":"942bc42b0f1048b384d9077b519c4740","parent_id":"f67288c3a0be4374b5d532b5dcc3aabc","latitude":"0.00000000","longitude":"0.00000000","altitude":"0.0000","author":"","source_url":"","is_todo":0,"todo_due":0,"todo_completed":0,"source":"joplin-desktop","source_application":"net.cozic.joplin-desktop","application_data":"","order":1764348817096,"markup_language":2,"is_shared":0,"share_id":"","conflict_original_id":"","master_key_id":"","user_data":"","deleted_time":0},"deleted":[]}
encryption_cipher_text: 
encryption_applied: 0
updated_time: 2025-11-28T21:03:19.450Z
created_time: 2025-11-28T21:03:19.450Z
type_: 13