Create & Publish an Open Source Service
Build, deploy, and share your full-stack application as an open source service in Open Source Cloud - from idea to published service in 7 simple steps.
What You'll Learn
Prerequisites
- Node.js 18+ installed
- A terminal or command prompt
- An Anthropic API key (for Claude Code)
- A GitHub account with Personal Access Token
Step-by-Step Guide
Install AI Coding Assistant
Choose and install an AI coding assistant that supports MCP (Model Context Protocol). We recommend Claude Code for this tutorial.
npm install -g @anthropic-ai/claude-codeAlternatively, you can use OpenAI Codex. Both support MCP protocol for infrastructure provisioning.
Tip: Make sure you have Node.js 18+ installed before proceeding.
Create Eyevinn Account & Configure MCP
Register at app.osaas.io using passwordless email authentication:
After creating your account, connect your AI assistant to Eyevinn through MCP:
claude mcp add --transport http osc https://mcp.osaas.io/mcpAuthentication will occur automatically in a browser window when you first use the MCP server.
Create Your Application
Start Claude Code in your project directory and describe what you want to build. For example, ask for a full-stack todo application:
> Create a full-stack todo application with a Node.js Express backend,
MariaDB database, and a responsive HTML/CSS/JavaScript frontend.
Use the OSC MCP server to provision the database.The AI will handle database provisioning via MCP, generate production-ready code, and create the complete project structure with security considerations.
Tip: Be specific about your requirements including database type, API structure, and frontend framework preferences.
Publish to GitHub
Add the GitHub MCP server to enable automatic repository creation. You'll need a GitHub Personal Access Token (Classic):
Important: You must use a Classic Personal Access Token, not a fine-grained token. Create one at GitHub Settings β Developer settings β Personal access tokens β Tokens (classic).
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ -H "Authorization: Bearer YOUR_GITHUB_PAT"Then ask your AI assistant to create a public repository and push all code:
> Create a public GitHub repository called "my-todo-app" and push all codeNote: Your repository must be public for submission to OSC. Ensure no sensitive data like credentials are committed.
Prefer to keep your code private? If you don't want to open source your application, you can deploy it as a private application instead. See the Deploy an Application with a Database tutorial for details.
Submit for Review
Use the OSC MCP server to submit your repository for review. Simply ask Claude:
> Submit my GitHub repository https://github.com/username/my-todo-app
to be added as an open source service in OSCThe AI will use the submit-open-source-repository tool to submit your service. Provide details like:
- Service name and description
- Category classification
- Required environment variables
The platform reviews submissions typically within hours to a day.
Deploy Your Application
After approval, your service will be available in the OSC catalog. Ask Claude to deploy it:
> Deploy my-todo-app service with the MariaDB credentialsThe AI will:
- Retrieve database connection credentials
- Deploy the service instance
- Configure environment variables
- Generate a public deployment URL
OSC automatically provides SSL certificates, load balancing, and monitoring.
Share Your Creation
Your application is now live at a public URL! Others can deploy your service from the OSC catalog. Share your work with the community:
- Post about it on social media
- Add it to your portfolio
- Write a blog post about your experience
- Help others by answering questions about your service
What's next? Consider adding features like authentication, file uploads, real-time updates, PWA support, or creating a mobile app version - all achievable through similar AI-assisted prompts.
Congratulations!
You've successfully published your first open source service to OSC. Your application is now available for anyone to deploy with a single click, and you're contributing to the open source ecosystem.
Why Publish on OSC?
No Vendor Lock-In
Built entirely on open-source technologies with full data ownership and portability.
Cost-Effective
Free tier available with pay-as-you-go pricing. No upfront costs or commitments.
AI-Native Infrastructure
Provision and manage infrastructure through MCP protocol with natural language.
Complete Stack
Access databases, storage, media services, and 200+ open source services.
Ready to Build More?
Explore other tutorials or check out the service catalog to see what's possible with Open Source Cloud.