MCPサーバー（ファイルシステム）のDocker設定手順

このドキュメントでは、Model Context Protocol (MCP) のファイルシステムサーバーをDockerを使用してセットアップする手順を説明します。

前提条件

Docker Desktopがインストールされていること
GitがインストールされていてGitHubにアクセスできること
Claude Desktopがインストールされていること

セットアップ手順

1. リポジトリのクローン

git clone https://github.com/modelcontextprotocol/servers.git
cd servers

2. Dockerイメージのビルド

docker build -t mcp/filesystem -f src/filesystem/Dockerfile .

3. claude_desktop_config.jsonの設定

claude_desktop_config.json に以下の設定を追加します：

{
    "mcpServers": {
        "filesystem": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "--mount", "type=bind,src=<YOUR_LOCAL_PATH>,dst=/projects/<MOUNT_POINT>",
                "mcp/filesystem",
                "/projects"
            ]
        }
    }
}

設定項目の説明

パラメータ	説明	例
`src`	アクセスを許可するローカルディレクトリのパス	`C:/Users/username/Documents`
`dst`	Dockerコンテナ内でマウントされるパス（必ず `/projects` 配下）	`/projects/docs`
最後の引数	MCPサーバーのルートディレクトリ	`/projects`

4. 動作確認

設定が正しく行われたかを確認するには、以下の点をチェックします：

Claude Desktopが正常に起動すること
ファイルシステムへのアクセスが可能なこと（例：/projects 配下のディレクトリ一覧が取得できる）

トラブルシューティング

よくある問題と解決方法

error "Docker buildが失敗する場合"
- Dockerfileが存在することを確認
- リポジトリが正しくクローンされているか確認
  - git clone コマンドが成功したか
  - servers ディレクトリに移動できているか
- Dockerデーモンが起動しているか確認
  - Docker Desktopが起動しているか
  - docker ps コマンドが実行できるか
error "ファイルにアクセスできない場合"
- パスの確認
  - マウントパスが /projects 配下になっているか
  - Windowsのパスはスラッシュ（/）を使用しているか
- 権限の確認
  - マウントしたディレクトリのパーミッション
  - Docker Desktopのファイル共有設定

参考情報

注意点

セキュリティ上の理由から、必要最小限のディレクトリのみをマウントすることを推奨
機密情報を含むディレクトリへのアクセスには十分注意が必要