🧠 Smart Workspace Manager

🧠 Smart Workspace Manager

将个人工作区连接到 AI，全面提升工作效率。

Smart Workspace Manager 是一个安全、以本地为先的 Model Context Protocol (MCP) 服务，可将你的文件、笔记和项目提供给 Claude Desktop、Cursor IDE 等 AI 助手，以及自定义的大模型工作流。

该项目专为 macOS（Silicon）开发者打造，可将你的私有文件系统与大语言模型连接起来，让 AI 能够搜索、读取、总结、创建和整理文档，同时让你全面掌控数据并保护隐私。

---

✨ 主要功能

• 📚 资源发现：将文件、文件夹和笔记作为结构化的 MCP 资源提供。
• 🔎 智能搜索：按名称、路径或关键词搜索工作区内容。
• 📝 文档摘要：快速总结会议笔记、文章或项目计划。
• 🗂️ 文件创建与整理：创建、重命名、移动以及（可选）删除文件。
• ⚙️ 可配置且安全：全面控制文件类型、大小限制和可写操作。
• 🔌 兼容 MCP：无需自定义集成，即可连接任何支持 MCP 的客户端。
• 🛡️ 本地优先的隐私保护：你的数据不会离开本机。

---

🛠 工作原理

• 在 Mac 上运行符合 MCP 标准的服务。
• 通过标准输入输出或 HTTP（未来支持）连接大模型应用。
• 将你的工作区目录（例如 ~/Documents/Workspace）表示为：
  • 资源（文件和元数据）
  • 工具（搜索、总结、创建文件等）
• 在用户控制下，允许大模型查询、分析和修改本地内容。
• 所有破坏性操作（删除、移动）都受安全配置限制。

---

🏛️ 技术概览

组件	描述
MCP 服务	使用官方 Python MCP SDK 构建
传输方式	Stdio（本地连接），SSE（计划支持）
资源	通过 URI 提供的文件（.txt、.md、.pdf）
工具	通过 JSON Schema 验证的函数（例如搜索、总结、创建）
配置	.env 文件 + 命令行覆盖项
安全性	默认只读，并提供精细的工具访问控制

---

🚀 开始使用

前置条件

• macOS（Silicon / ARM64）
• Python 3.10+
• Node.js（可选，用于测试 MCP Inspector 等工具）
• 兼容 MCP 的客户端（例如 Claude Desktop）

安装

# Clone the repository
git clone https://github.com/Harshil7875/Smart-Workspace-Manager-MCP-Server.git
cd Smart-Workspace-Manager-MCP-Server

# Create a virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

配置

在项目根目录中创建 .env 文件：

WORKSPACE_PATH=/Users/yourname/Documents/Workspace
ALLOWED_FILE_TYPES=.txt,.md,.pdf
MAX_FILE_SIZE_MB=5
ENABLE_DESTRUCTIVE_TOOLS=false

运行服务

python server.py

也可以通过 MCP 客户端（例如 Claude Desktop 配置）自动启动。

---

🛤️ 路线图

• MCP 服务基本框架
• 将工作区作为资源提供
• 实现搜索和总结工具
• 添加创建／移动／删除文件工具
• 支持订阅文件变更
• 集成 Sampling（大模型起草助手）
• 可选的远程支持（HTTP/SSE）
• 完善命令行工具打包

---

🧩 扩展

Smart Workspace Manager 专为扩展而构建：

• 通过定义简单的 JSON Schema 接口添加新工具。
• 自定义工作区扫描逻辑。
• 扩展功能以支持语义搜索或 AI 驱动的文件标记。

---

📜 许可证

MIT 许可证

---

🤝 参与贡献

欢迎贡献！

• Fork 此代码仓库
• 创建新分支（git checkout -b feature-name）
• 提交更改
• 发起 pull request

如果添加新功能，请务必更新测试和文档。

---

🧠 关于 Model Context Protocol

MCP 是一种新的开放标准，可安全、模块化地将大模型连接到外部工具、数据库和数据源。
了解更多信息，请访问 modelcontextprotocol.io。

---