🧠 Smart Workspace Manager

基本能力

产品定位

Smart Workspace Manager 是一个 MCP 服务器，旨在通过 AI 增强个人工作空间的生产力，特别适合开发者使用。

核心功能

• 资源发现：将文件、文件夹和笔记作为结构化 MCP 资源暴露。
• 智能搜索：通过名称、路径或关键词搜索工作空间内容。
• 文档摘要：快速总结会议记录、文章或项目计划。
• 文件创建与组织：创建、重命名、移动和（可选）删除文件。
• 可配置与安全：完全控制文件类型、大小限制和可写操作。
• MCP 兼容：无需自定义集成即可连接到任何支持 MCP 的客户端。
• 本地优先隐私：数据永远不会离开您的机器。

适用场景

• 开发者希望通过 AI 增强工作空间管理。
• 需要快速搜索和摘要文档的场景。
• 需要安全地允许 AI 访问和修改本地文件的场景。

工具列表

• 搜索工具：允许按名称、路径或关键词搜索文件。
• 摘要工具：快速生成文档摘要。
• 文件操作工具：创建、重命名、移动和删除文件（需配置）。

常见问题解答

• Q: 是否支持 Windows 或 Linux？ A: 目前仅支持 macOS (Silicon)。
• Q: 数据是否会离开本地机器？ A: 不会，所有数据处理均在本地完成。

使用教程

使用依赖

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

安装教程

# 克隆仓库
git clone https://github.com/Harshil7875/Smart-Workspace-Manager-MCP-Server.git
cd Smart-Workspace-Manager-MCP-Server

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate

# 安装依赖
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

调试方式

• 确保虚拟环境已激活。
• 检查 .env 文件配置是否正确。
• 使用 MCP 兼容客户端（如 Claude Desktop）进行连接测试。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。