local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Supports Claude Desktop configuration on macOS, allowing the setup of the MCP server to provide file system access capabilities to Claude.

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

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

特徴

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

インストール

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

mkdir mcp-claude-dev
cd mcp-claude-dev

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

uv venv

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

uv pip install -e .

プロジェクト構造

mcp-claude-dev/
├── claude_dev_server/
│   ├── __init__.py
│   ├── __main__.py
│   ├── server.py
│   └── file_manager.py
└── pyproject.toml

構成

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

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

次の構成を追加します。

{
  "mcpServers": {
    "claude-dev": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH_TO_YOUR_PROJECT",
        "run",
        "-m",
        "claude_dev_server",
        "PATH_TO_YOUR_WORKSPACE"
      ]
    }
  }
}

交換する：

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

使用法

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

セキュリティノート

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

発達

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

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

テストの実行

python -m pytest tests/

利用可能なツール

サーバーは次の 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 ライセンス - 必要に応じて自由に使用および変更できます。

貢献

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Claude Dev Server を使用すると、指定されたワークスペース内のファイルシステムと直接対話できるため、ユーザーはファイルおよびディレクトリ操作を実行し、自然言語コマンドを使用してソフトウェア開発でコード成果物を実装できます。

Related Resources

Reddit Discussion about this server