Skip to content

Feature/codespaces#90

Merged
crivetimihai merged 3 commits intoIBM:mainfrom
manavgup:feature/codespaces
Jun 11, 2025
Merged

Feature/codespaces#90
crivetimihai merged 3 commits intoIBM:mainfrom
manavgup:feature/codespaces

Conversation

@manavgup
Copy link
Copy Markdown
Collaborator

Closes #23

VS Code Dev Container support has been successfully implemented for the MCP Context Forge project. The implementation includes:

Created Files:

  1. .devcontainer/devcontainer.json - VS Code configuration with:

    • Python 3.11 container build
    • Python and Docker VS Code extensions
    • Post-creation command execution
    • Development environment variables
  2. .devcontainer/Dockerfile - Container definition featuring:

    • Python 3.11 slim base image
    • Docker CLI for container management
    • Essential development tools (curl, git, build-essential)
    • Python package managers (pip, setuptools, pdm, uv)
    • Proper dependency installation
  3. .devcontainer/postCreateCommand.sh - Setup script that:

    • Copies .env.example to .env if needed
    • Runs make install-dev to install development dependencies
    • Executes make test to verify environment setup
  4. Updated README.md - Added comprehensive "Quick Start (VS Code Dev Container)" section with:

    • Prerequisites and setup instructions
    • VS Code and GitHub Codespaces usage
    • List of included tools and features
  5. Architecture Decision Record - docs/docs/architecture/adr/005-vscode-devcontainer-support.md documenting:

    • Context and rationale for the decision
    • Implementation details and consequences
    • Alternatives considered
    • Verification process

Key Features:

  • Instant onboarding: New contributors can start developing with one click
  • Consistent environment: Python 3.11, Docker CLI, and all project dependencies pre-installed
  • GitHub Codespaces support: Cloud-based development without local setup
  • Automated verification: Tests run automatically to ensure environment works
  • Make target integration: Leverages existing make install-dev and make test workflows
  • Development mode: Pre-configured with MCPGATEWAY_DEV_MODE=true

The devcontainer is now ready for use. Contributors can simply:

  1. Clone the repository
  2. Open in VS Code
  3. Click "Reopen in Container" when prompted
  4. Wait for automatic setup and verification
  5. Start developing immediately

This addresses all requirements from the PR including instant onboarding, consistent reproducible development environments, and comprehensive tooling setup.

@manavgup manavgup requested a review from crivetimihai as a code owner June 11, 2025 16:52
@crivetimihai crivetimihai merged commit 2ae96ad into IBM:main Jun 11, 2025
13 of 15 checks passed
vk-playground pushed a commit to vk-playground/mcp-context-forge that referenced this pull request Sep 14, 2025
Feature/codespaces

Signed-off-by: Mihai Criveti <crivetimihai@gmail.com>
vk-playground pushed a commit to vk-playground/mcp-context-forge that referenced this pull request Sep 14, 2025
vk-playground pushed a commit to vk-playground/mcp-context-forge that referenced this pull request Sep 16, 2025
Feature/codespaces
Signed-off-by: Vicky Kuo <vicky.kuo@ibm.com>
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.

[FEATURE]: Add VS Code Devcontainer support

2 participants