Skip to content

Conversation

@abnerjacobsen
Copy link

Summary

  • Adds a production-ready Docker setup to run skillport-mcp in Remote (HTTP) mode (default: 0.0.0.0:3000).
  • Includes a multi-stage Dockerfile.mcp based on Astral’s uv image, plus a helper build script.
  • Documents build/run instructions for both HTTP (default) and STDIO (override) usage.

Details

  • Dockerfile.mcp: Multi-stage build using uv, installs the workspace and exposes port 3000. Default command starts:
    skillport-mcp --http --host 0.0.0.0 --port 3000
  • scripts/build-mcp-docker.sh: Convenience script to build/tag the Docker image and print example docker run commands.
  • DOCKER_MCP.md: Quickstart documentation for Docker usage.
  • .dockerignore: Keeps the Docker build context minimal and predictable.

Configuration Notes

  • SKILLPORT_SKILLS_DIR is expected to be provided via environment variables (typically pointing to a mounted volume).
  • Default MCP HTTP endpoint becomes available at: http://:3000/mcp

Motivation

  • This makes it straightforward to deploy skillport-mcp as a containerized HTTP service, enabling remote MCP usage without requiring local uv tooling on the host machine.

fix(dev): ensure uv sync installs skillport-mcp for local MCP server runs
Add .dockerignore to exclude unnecessary files from Docker build.
Create DOCKER_MCP.md to document Docker setup and usage instructions.
Add Dockerfile.mcp for multi-stage build of SkillPort MCP server.
Include build-mcp-docker.sh script for building Docker image.
@gotalab
Copy link
Owner

gotalab commented Jan 17, 2026

Thanks for the awesome PR!
I'll review it tomorrow or the day after.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants