Claude Dev Server

クロード・デヴ・サーバー

指定されたワークスペース内で直接ファイル システム アクセスを提供することにより、Claude がソフトウェア開発を支援できるようにするモデル コンテキスト プロトコル (MCP) サーバー。

特徴

• 🔍 ファイルの内容を読み取る
• ✍️ ファイルの書き込みと変更
• 📁 ディレクトリを作成する
• 📋 ファイルとディレクトリの一覧表示
• ℹ️ ファイル情報を取得する
• 🛠️ Claude から直接コード成果物を実装する

インストール

1. Python 3.10以降がインストールされていることを確認してください
2. 新しいプロジェクト ディレクトリを作成します。

3. UV を使用して仮想環境を設定します。

4. 編集可能なモードでパッケージをインストールします。

プロジェクト構造

構成

Claude Desktop でサーバーを使用するには、Claude Desktop 構成ファイルにサーバーを追加します。

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

次の構成を追加します。

交換する：

• PATH_TO_YOUR_PROJECT mcp-claude-dev ディレクトリへの絶対パスで指定します。
• PATH_TO_YOUR_WORKSPACE 、Claude がファイルアクセスを持つディレクトリへの絶対パスです。

使用法

1. Claudeデスクトップを起動
2. サーバーはツールメニュー（ハンマーアイコン）に表示されます。
3. Claude に次のことを依頼できるようになりました。
   • ファイルの読み取り: 「file.txt の内容を読み取ることができますか?」
   • ファイルの書き込み:「基本的な Flask アプリで example.py という新しいファイルを作成します」
   • ディレクトリの一覧:「現在のディレクトリにはどのようなファイルがありますか?」
   • ディレクトリの作成: 「'src' という新しいディレクトリを作成します」
   • ファイル情報を取得:「main.py のサイズと変更日は?」
   • 実装コード: 「フィボナッチ数を計算する Python 関数を記述し、math_utils.py に保存する」

セキュリティノート

• サーバーは指定されたワークスペースディレクトリ内のファイルへのアクセスのみを許可します
• すべてのファイル操作には、ワークスペースに対する明示的なパスが必要です。
• ワークスペース外のディレクトリトラバーサルの試みはブロックされます
• 変更検出のためにファイル監視が実装されています

発達

プロジェクトに貢献するには:

1. リポジトリをクローンする
2. 開発依存関係をインストールする
3. 変更を加える
4. プルリクエストを送信する前に徹底的にテストする

テストの実行

利用可能なツール

サーバーは次の MCP ツールを公開します。

• read_file(path: str) -> str : ファイルの内容を読み取る
• write_file(path: str, content: str) -> str : ファイルにコンテンツを書き込む
• list_files(path: str = "") -> str : ディレクトリの内容を一覧表示する
• create_directory(path: str) -> str : 新しいディレクトリを作成する
• get_file_info(path: str) -> str : ファイルのメタデータを取得する
• implement_artifact(path: str, content: str) -> str : コードアーティファクトを保存する

エラー処理

サーバーには、次の堅牢なエラー処理機能が含まれています。

• 無効なパス
• ワークスペース外へのアクセス試行
• ファイル操作の失敗
• 権限の問題

ライセンス

MIT ライセンス - 必要に応じて自由に使用および変更できます。

貢献

貢献を歓迎します！貢献ガイドラインをお読みいただき、改善点があればプルリクエストを送信してください。