Docker mount error when installing airis-mcp-gateway via superclaude mcp

[Natsuko410]

Bug: airis-mcp-gateway fails to start via superclaude mcp

Description

Installing AIRIS MCP Gateway using the superclaude mcp command fails.
The Docker container airis-mcp-gateway cannot start due to a volume mount error involving mcp-config.json.

Steps to reproduce

superclaude mcp

...

Select option (g for gateway, 0 for all, or comma-separated numbers) [g]: g

🚀 Installing AIRIS MCP Gateway (Recommended)
   This provides 60+ tools through a single endpoint with 98% token reduction.

   ✅ Docker is available
   📁 Installation directory: /home/natsuko/.superclaude/airis-mcp-gateway
   📥 Downloading docker-compose configuration...
   🐳 Starting AIRIS MCP Gateway containers...
   ❌ Failed to start containers:  Container airis-serena Running 
 Container airis-mcp-gateway-core Running 
 Container airis-mcp-gateway-core Waiting 
 Container airis-mcp-gateway-core Healthy 
 Container airis-mcp-gateway Starting 
Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: error mounting "/home/natsuko/.superclaude/airis-mcp-gateway/mcp-config.json" to rootfs at "/app/mcp-config.json": mount src=/home/natsuko/.superclaude/airis-mcp-gateway/mcp-config.json, dst=/app/mcp-config.json, dstFd=/proc/thread-self/fd/11, flags=MS_BIND|MS_REC: not a directory: Are you trying to mount a directory onto a file (or vice-versa)? Check if the specified host path exists and is the expected type

Environment

• OS: Linux (Nobara)
• Claude Code : 2.1.20 native installation (fresh install)
• SuperClaude : 4.2.0
• Docker: installed and running

[davidabreu7]

same thing here. No workarounds for this?

Environment
OS: MacOS (26.2 Tahoe)
Claude Code : 2.1.20
SuperClaude: upgrading from 4.1.9 to 4.2.0 using superclaude mcp to install AIRIS gateway)
Docker: installed and running

[nabiko02]

Same here

OS: Arch Linux - 6.18.6-arch1-1
Claude Code : 2.1.20
SuperClaude: 4.2.0
Docker: installed and running

[Cius]

Few days ago I encountered the same problem when trying to install.

When I checked in .superclaude/mcp-airis-gateway directory, it turns out that the mcp-config.json is created but as a directory. Then I delete that mcp-config.json directory and manually create empty file named mcp-config.json and rerun the MCP installation, and now it's completed.

Hope that helps.

[nabiko02]

@Cius If you /mcp inside claude can you authenticate to the "Airis-mcp-gateway MCP Server" ?
Doing so give me an error:
Error: "/" cannot be parsed as a URL against "npx"

[davidabreu7]

I have the impression that the correct mcp-config.json would the the official AIRIS config file mcp-config.json
if you just put an empty file I think the installation would be imcomplete

[nabiko02]

already tried and unfortunately having the same behavior :/
Error: "/" cannot be parsed as a URL against "npx"

[davidabreu7]

for me the AIRIS docker container is UP but claude code cant properly communicate with AIRIS
also I took a look at the logs and the serena sidecar container is giving 404 error on /health endpoint

[Cius]

@Cius If you /mcp inside claude can you authenticate to the "Airis-mcp-gateway MCP Server" ? Doing so give me an error: Error: "/" cannot be parsed as a URL against "npx"

@nabiko02 looking at https://github.com/agiletec-inc/airis-mcp-gateway, I put this value for the url in the .claude.json: http://localhost:9400/sse

the section would be:

"airis-mcp-gateway": {
      "type": "sse",
      "url": "http://localhost:9400/sse"
    }

[davidabreu7]

maybe @kazukinakai can help with this issue

[kazukinakai]

原因と修正

原因: docker-compose.yml が ./mcp-config.json をマウントしようとするが、ファイルが存在しない場合、Docker はディレクトリとして作成してしまう。

修正: PR #520 で対応しました。

修正内容:

1. docker compose up の前に mcp-config.json を作成
2. upstream の mcp-config.json.example をダウンロード
3. ダウンロード失敗時は最小限の設定 {"mcpServers": {}} を作成
4. 既にディレクトリとして作成されてしまった場合は自動修正
5. profiles ディレクトリも事前に作成

既存環境での修正方法 (PR マージ前):

# 1. 既存のディレクトリを削除
rm -rf ~/.superclaude/airis-mcp-gateway/mcp-config.json

# 2. ファイルとして作成
curl -o ~/.superclaude/airis-mcp-gateway/mcp-config.json \
  https://raw.githubusercontent.com/agiletec-inc/airis-mcp-gateway/main/mcp-config.json.example

# 3. profiles ディレクトリ作成
mkdir -p ~/.superclaude/airis-mcp-gateway/profiles

# 4. 再起動
cd ~/.superclaude/airis-mcp-gateway && docker compose up -d

関連PR: #520