🧠 Smart Workspace Manager

🧠 Smart Workspace Manager

個人のワークスペースを AI に接続して、生産性を大幅に高めましょう。

Smart Workspace Manager は、安全性を重視したローカルファーストの Model Context Protocol (MCP) サーバーです。Claude Desktop、Cursor IDE、カスタム LLM ワークフローなどの AI アシスタントに、ファイル、メモ、プロジェクトを公開します。

macOS（Silicon）を使う開発者向けに構築されており、プライベートなファイルシステムと大規模言語モデルをつなぎます。AI はユーザーが完全に管理し、プライバシーを保護した状態で、ドキュメントの 検索、読み取り、要約、作成、整理 を行えます。

---

✨ 主な機能

• 📚 リソースの検出：ファイル、フォルダー、メモを構造化された MCP リソースとして公開します。
• 🔎 スマート検索：名前、パス、キーワードでワークスペースの内容を検索します。
• 📝 ドキュメントの要約：会議メモ、記事、プロジェクト計画をすばやく要約します。
• 🗂️ ファイルの作成と整理：ファイルの作成、名前の変更、移動、（任意で）削除ができます。
• ⚙️ 設定可能で安全：ファイルの種類、サイズ制限、書き込み可能な操作を完全に管理できます。
• 🔌 MCP 互換：カスタム連携なしで、MCP 対応のあらゆるクライアントに接続できます。
• 🛡️ ローカルファーストのプライバシー：データが端末の外に出ることはありません。

---

🛠 仕組み

• Mac 上で MCP 準拠のサーバーを実行します。
• 標準入出力または HTTP（今後対応予定）を介して LLM アプリケーションに接続します。
• ワークスペースのディレクトリ（例：~/Documents/Workspace）を次のように扱います。
  • リソース（ファイルとメタデータ）
  • ツール（検索、要約、ファイル作成など）
• ユーザーの管理下で、LLM がローカルコンテンツを 照会、分析、変更 できるようにします。
• 破壊的な操作（削除、移動）はすべて、安全な設定によって制限されます。

---

🏛️ 技術概要

コンポーネント	説明
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（LLM の下書き作成アシスタント）を統合
• リモート（HTTP/SSE）対応（任意）
• 洗練された CLI ツールのパッケージ化

---

🧩 拡張

Smart Workspace Manager は拡張性を重視して構築されています。

• シンプルな JSON Schema インターフェースを定義して、新しいツールを追加できます。
• ワークスペースのスキャンロジックをカスタマイズできます。
• セマンティック検索や AI によるファイルのタグ付けに対応するよう拡張できます。

---

📜 ライセンス

MIT ライセンス

---

🤝 コントリビュート

コントリビュートを歓迎します。

• リポジトリをフォークします
• 新しいブランチを作成します（git checkout -b feature-name）
• 変更をコミットします
• プルリクエストを作成します

新機能を追加する場合は、テストとドキュメントも更新してください。

---

🧠 Model Context Protocol について

MCP は、LLM を外部ツール、データベース、データソースに安全かつモジュール式に接続するための、新しいオープン標準です。
詳しくは modelcontextprotocol.io をご覧ください。

---