All Tutorials
AI Agents
Intermediate
15 min

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

Configure AI assistants with MCP for OSC
Build full-stack applications with AI help
Publish projects to GitHub automatically
Submit and deploy services on Open Source Cloud

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

1

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-code

Alternatively, you can use OpenAI Codex. Both support MCP protocol for infrastructure provisioning.

Tip: Make sure you have Node.js 18+ installed before proceeding.

2

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/mcp

Authentication will occur automatically in a browser window when you first use the MCP server.

3

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.

4

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 code

Note: 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.

5

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 OSC

The 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.

6

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 credentials

The 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.

7

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.