Config tweaks for docker

- Remove `$` interpolation for env
- Allow puppeteer to work headless in docker, headful with npx

src/aws-kb-retrieval-server/README.md

@@ -34,7 +34,7 @@ Add this to your `claude_desktop_config.json`:
   "mcpServers": {
     "aws-kb-retrieval": {
       "command": "docker",
-      "args": [ "run", "-i", "--rm", "-e", "AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID", "-e", "AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY", "-e", "AWS_REGION=$AWS_REGION", "ai/mcp-aws-kb-retrieval-server" ],
+      "args": [ "run", "-i", "--rm", "-e", "AWS_ACCESS_KEY_ID", "-e", "AWS_SECRET_ACCESS_KEY", "-e", "AWS_REGION", "ai/mcp-aws-kb-retrieval-server" ],
       "env": {
         "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY_HERE",
         "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_ACCESS_KEY_HERE",

src/brave-search/README.md

@@ -48,7 +48,7 @@ Add this to your `claude_desktop_config.json`:
         "-i",
         "--rm",
         "-e",
-        "BRAVE_API_KEY=$BRAVE_API_KEY",
+        "BRAVE_API_KEY",
         "ai/mcp-brave-search"
       ],
       "env": {

src/everart/README.md

@@ -17,7 +17,7 @@ Add to Claude Desktop config:
   "mcpServers": {
     "everart": {
       "command": "docker",
-      "args": ["run", "-i", "--rm", "-e", "EVERART_API_KEY=$EVERART_API_KEY", "ai/mcp-everart"],
+      "args": ["run", "-i", "--rm", "-e", "EVERART_API_KEY", "ai/mcp-everart"],
     "env": {
       "EVERART_API_KEY": "your_key_here"
     }

src/filesystem/Dockerfile

@@ -22,4 +22,6 @@ ENV NODE_ENV=production
 
 RUN npm ci --ignore-scripts --omit-dev
 
-ENTRYPOINT ["node", "dist/index.js"]
+WORKDIR /projects
+
+ENTRYPOINT ["node", "/app/dist/index.js"]

src/filesystem/README.md

@@ -109,6 +109,7 @@ Add this to your `claude_desktop_config.json`:
 Note: you can provide sandboxed directories to the server by mounting them to `/projects`. Adding the `ro` flag will make the directory readonly by the server.
 
 ### Docker
+Note: all directories must be mounted to `/projects` by default.
 
 ```json
 {
@@ -122,7 +123,6 @@ Note: you can provide sandboxed directories to the server by mounting them to `/
         "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
         "--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
         "--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
-        "--env", "DOCKER_ROOT_WORKSPACE=/projects",
         "ai/mcp-filesystem"
       ]
     }

src/filesystem/index.ts

@@ -20,8 +20,15 @@ const args = process.argv.slice(2);
 
 let allowedDirectories: string[] = [];
 
-if (process.env.DOCKER_ROOT_WORKSPACE) {
+let hasProjectsDirectory = false;
-  allowedDirectories = await fs.readdir(process.env.DOCKER_ROOT_WORKSPACE);
+
+// If the projects directory has contents, use it as the root workspace
+const projectsContents = await fs.readdir('/projects');
+if (projectsContents.length > 0) {
+  hasProjectsDirectory = true;
+  allowedDirectories = projectsContents.map(dir =>
+    normalizePath(path.resolve(expandHome(dir)))
+  );
 }
 else {
   if (args.length === 0) {
@@ -51,7 +58,7 @@ function expandHome(filepath: string): string {
 await Promise.all(allowedDirectories.map(async (dir) => {
   try {
     const stats = await fs.stat(dir);
-    if (!stats.isDirectory()) {
+    if (!stats.isDirectory() && !hasProjectsDirectory) {
       console.error(`Error: ${dir} is not a directory`);
       process.exit(1);
     }
@@ -614,9 +621,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const validPath = await validatePath(parsed.data.path);
         const info = await getFileStats(validPath);
         return {
-          content: [{ type: "text", text: Object.entries(info)
+          content: [{
+            type: "text", text: Object.entries(info)
               .map(([key, value]) => `${key}: ${value}`)
-            .join("\n") }],
+              .join("\n")
+          }],
         };
       }
 

src/github/README.md

@@ -236,7 +236,7 @@ To use this with Claude Desktop, add the following to your `claude_desktop_confi
         "-i",
         "--rm",
         "-e",
-        "GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PERSONAL_ACCESS_TOKEN",
+        "GITHUB_PERSONAL_ACCESS_TOKEN",
         "ai/mcp-github"
       ],
       "env": {

src/gitlab/README.md

@@ -118,9 +118,9 @@ Add the following to your `claude_desktop_config.json`:
       "args": [
         "run",
         "-e",
-        "GITLAB_PERSONAL_ACCESS_TOKEN=$GITLAB_PERSONAL_ACCESS_TOKEN",
+        "GITLAB_PERSONAL_ACCESS_TOKEN",
         "-e",
-        "GITLAB_API_URL=$GITLAB_API_URL",
+        "GITLAB_API_URL",
         "ai/mcp-gitlab"
       ],
       "env": {

src/google-maps/README.md

@@ -71,7 +71,7 @@ Add the following to your `claude_desktop_config.json`:
         "-i",
         "--rm",
         "-e",
-        "GOOGLE_MAPS_API_KEY=$GOOGLE_MAPS_API_KEY",
+        "GOOGLE_MAPS_API_KEY",
         "ai/mcp-google-maps"
       ],
       "env": {

src/puppeteer/README.md

@@ -72,7 +72,7 @@ Here's the Claude Desktop configuration to use the Puppeter server:
   "mcpServers": {
     "puppeteer": {
       "command": "docker",
-      "args": ["run", "-i", "--rm", "--init", "ai/mcp-puppeteer"]
+      "args": ["run", "-i", "--rm", "--init", "-e", "DOCKER_CONTAINER=true", "ai/mcp-puppeteer"]
     }
   }
 }

src/puppeteer/index.ts

@@ -108,7 +108,9 @@ const screenshots = new Map<string, string>();
 
 async function ensureBrowser() {
   if (!browser) {
-    browser = await puppeteer.launch({ headless: true, args: ["--no-sandbox"] });
+    const npx_args = { headless: false }
+    const docker_args = { headless: true, args: ["--no-sandbox", "--single-process", "--no-zygote"] }
+    browser = await puppeteer.launch(process.env.DOCKER_CONTAINER ? docker_args : npx_args);
     const pages = await browser.pages();
     page = pages[0];
 

src/slack/README.md

@@ -121,9 +121,9 @@ Add the following to your `claude_desktop_config.json`:
         "-i",
         "--rm",
         "-e",
-        "SLACK_BOT_TOKEN=$SLACK_BOT_TOKEN",
+        "SLACK_BOT_TOKEN",
         "-e",
-        "SLACK_TEAM_ID=$SLACK_TEAM_ID",
+        "SLACK_TEAM_ID",
         "ai/mcp-slack"
       ],
       "env": {