AI导哈

文件系统MCP服务

为Claude Desktop提供本地文件系统访问、目录结构生成和文档分析功能的MCP服务器集成工具。

  • by SudharshanArvind
  • Batchfile
  • 本地部署
  • 更新于
在 GitHub 查看 SudharshanArvind/MCP_Filesystem_and_Fetch_Servers-Claude_Desktop_Integration

使用说明

📦 MCP文件系统和提取服务器——克劳德桌面集成

此存储库包含在Claude Desktop中运行模型上下文协议（MCP）服务器的完整设置，包括：

  • 一个功能齐全的文件系统MCP服务器

  • 基于Python的自定义Fetch MCP服务器

  • 一个与Windows兼容的npx包装器，用于避免路径错误

  • 生成项目树结构和高级技术文档的模板、文档和示例

本项目展示了如何扩展Claude Desktop，使其可以浏览本地目录、读取文件，并通过自定义MCP工具与您的计算机进行交互。

🚀 特性

🔹 文件系统MCP服务器

允许Claude Desktop执行以下操作：

  • 列出文件夹

  • 读取文件内容

  • 生成树结构

  • 协助文档编制、代码检查和分析

🔹 自定义获取MCP服务器

处理自定义获取或处理逻辑的Python服务器。 适用于：

  • 正在获取外部API数据

  • 解决资产

  • 自动化项目特定任务

🔹 Windows路径兼容性

包括一个简单的npx-wrapper.cmd，用于修复Windows“C:\Program Files”破坏文件系统MCP服务器的问题。

🔹 文档工具

示例和模板：

  • 生成目录树

  • 制作高级技术文档

  • 组织LLM辅助分析的项目文件

📁 项目结构

mcp-project/
│
├── npx-wrapper/
│   └── npx.cmd
│
├── docs/
│   ├── tree_structure.txt
│   └── technical_documentation.md
│
├── claude_config_template.json
├── requirements.txt
└── README.md

🛠️ 安装说明

1.️⃣ 安装Python依赖项

pip install -r requirements.txt

需要Python 3.10+。

2.️⃣ 安装Node.js（用于文件系统MCP服务器）

下载地址： https://nodejs.org/

建议使用Node.js 18+。

3.️⃣ （仅限Windows）修复npx路径问题

如果Claude Desktop无法运行基于节点的文件系统服务器，请使用附带的包装器：

工具/npx-wrapper.cmd

@"C:\Program Files\nodejs\npx.cmd" %*

这确保了npx即使安装在有空格的文件夹中也能正常工作。

4.️⃣ 配置Claude桌面

复制提供的模板：

claude_config_template.json

进入您的Claude Desktop配置目录：

C:\Users\<YOUR_USERNAME>\AppData\Roaming\Claude\claude_desktop_config.json

修改文件中的路径以匹配您的系统。

🧪 用法

📂 生成树结构

在Claude Desktop内部，运行：

Show me the tree structure of this project.

或指定路径：

Generate a directory tree for this folder.

Claude将使用文件系统MCP服务器读取文件并生成结构化输出。

📘 生成高级技术文档

问克劳德：

Analyze this project and generate high-level technical documentation.

Claude将使用MCP服务器读取文件并生成详细的技术文档.md。

🔍 为什么这个项目存在

此存储库演示了如何：

  • 将Claude Desktop与本地系统工具集成

  • 使用MCP服务器增强AI工作流程

  • 自动化文档和项目自检

  • 可靠地处理Windows特定的Node.js路径问题

它为开发人员探索模型上下文协议的全部功能提供了一个入门模板。

🤝 贡献

欢迎贡献、改进或添加MCP模块。

📄 许可证

MIT许可证。

相关 MCP