📦 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\\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许可证。