https://github.com/ai-ql/mcp-devcontainers
MCP server for devcontainer to generate and configure development containers directly from devcontainer.json configuration files.
https://github.com/ai-ql/mcp-devcontainers
ai-agent ai-agent-tools devcontainer mcp mcp-server
Last synced: 2 months ago
JSON representation
MCP server for devcontainer to generate and configure development containers directly from devcontainer.json configuration files.
- Host: GitHub
- URL: https://github.com/ai-ql/mcp-devcontainers
- Owner: AI-QL
- License: mit
- Created: 2025-07-21T13:06:41.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-08-04T13:24:15.000Z (2 months ago)
- Last Synced: 2025-08-04T15:51:29.041Z (2 months ago)
- Topics: ai-agent, ai-agent-tools, devcontainer, mcp, mcp-server
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/mcp-devcontainers
- Size: 85.9 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# MCP Devcontainers
[](https://www.npmjs.com/package/mcp-devcontainers)
[](https://github.com/AI-QL/mcp-devcontainers/blob/main/LICENSE)
MCP server for devcontainer to generate and configure development containers directly from devcontainer.json configuration files.
## 📌 Pre-condition
This project is built with Node.js. For local development, you can either:
- Install `Node.js` on your machine, or
- Use the provided [devcontainer](.devcontainer/devcontainer.json) virtual environment.
You may run the project without installing `Node.js` locally by using `npx`:
```bash
npx -y mcp-devcontainers
```
**Docker is required** in the execution environment:
- For **local MCP server**: Install Docker on your local machine
- For **remote MCP server**: Install Docker on the remote server
> 📦 Docker installation guide: https://docs.docker.com/get-started/get-docker/
## 🚀 Getting Started
- Build: `npm run build` - Compiles TypeScript to JavaScript
- Watch mode: `npm run watch` - Automatically rebuilds on file changes
- Prepare release: `npm run prepare` - Prepares the package for publishing
- Run ESLint: `npm run lint` - Executes ESLint for code validation
- Fix ESLint issues: `npm run lint:fix` - Automatically fixes ESLint errors
## MCP Transport
- Start server: `npm start` - Launches the MCP server with **stdio transport**
- Start SSE server: `npm start sse` - Runs the MCP server with **Server-Sent Events transport**
- Start Streamable HTTP server: `npm start http` - Starts the MCP server with **Streamable HTTP transport**
## 📚 Tools
Tools are built on the [devcontainers/cli](https://github.com/devcontainers/cli)
They enable you to generate and configure development containers directly from `devcontainer.json` configuration files:
- ### devcontainer_up
- workspaceFolder: Path to the workspace folder (string)
- outputFilePath: Path for output logs (string)
> Initializes and starts a devcontainer environment in the specified workspace folder. Ensures the devcontainer is operational and ready for development tasks.
- ### devcontainer_run_user_commands
- workspaceFolder: Path to the workspace folder (string)
- outputFilePath: Path for output logs (string)
> Executes user-defined postCreateCommand and postStartCommand scripts within the devcontainer for the specified workspace. Use this to run setup or initialization tasks after container startup.
- ### devcontainer_exec
- workspaceFolder: Path to the workspace folder (string)
- outputFilePath: Path for output logs (string)
- command: Command to execute (array of string)
> Runs a custom shell command inside the devcontainer for the specified workspace. Useful for executing arbitrary commands or scripts within the devcontainer environment.
## 🤝 Contributing
We welcome contributions of any kind to this project, including feature enhancements, UI improvements, documentation updates, test case completions, and syntax corrections. I believe that a real developer can write better code than AI, so if you have concerns about certain parts of the code implementation, feel free to share your suggestions or submit a pull request.
Please review our [Code of Conduct](CODE_OF_CONDUCT.md). It is in effect at all times. We expect it to be honored by everyone who contributes to this project.
For more information, please see [Contributing Guidelines](CONTRIBUTING.md)
## 🐞 Opening an Issue
Before creating an issue, check if you are using the latest version of the project. If you are not up-to-date, see if updating fixes your issue first.
### 🔒 Reporting Security Issues
Review our [Security Policy](SECURITY.md). Do not file a public issue for security vulnerabilities.
## ⭐ Credits
Written by [@AIQL.com](https://github.com/AI-QL).
## 📜 License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.