Skip to content

Develop a MCP Server

Choreo allows you to create and deploy MCP Server applications in Python and Node.js.

In this guide, you will:

  • Deploy an stdio-based github-mcp-server in Choreo over SSE (Server-Sent Events) using a NodeJs buildpack.

Prerequisites

  1. If you're signing in to the Choreo Console for the first time, create an organization:

    1. Go to https://console.choreo.dev/ and sign in using your preferred method.
    2. Enter a unique organization name. For example, Stark Industries.
    3. Read and accept the privacy policy and terms of use.
    4. Click Create.

    This creates the organization and opens the Project Home page of the default project created for you.

  2. Create a GitHub Personal Access Token (PAT) for your account.

Step 1: Create a MCP Server component

To create a mcp server component, follow these steps:

  1. Go to https://console.choreo.dev/ and sign in. This opens the project home page.
  2. If you already have one or more components in your project, click + Create. Otherwise, proceed to the next step.
  3. Click View All Component Types link button.
  4. Click the MCP Server card.

  5. Under MCP Server Metadata, enter the following details:

    Field Value
    Server Package @modelcontextprotocol/server-github
    Run Command npx -y @modelcontextprotocol/server-github

  6. Select NodeJs as the buildpack.

  7. Provide component display name, name and description:

    Info

    The Component Name field must be unique and cannot be changed after creation.

    Field Value
    Component Display Name GitHub MCP Server
    Component Name github-mcp-server
    Description Mcp server for GitHub

  8. Click Create. This creates the component and lists it under Component Listing on the project home page.

You have successfully created the server. The initial build has been triggered. Please wait until it completes. If you need to rebuild the component later, follow the steps below.

Step 2: Build

  1. On the project home page, click on the GitHub Mcp Server component you created. This takes you to the component overview page.
  2. In the left navigation menu, click Build.

  3. On the Build page, click Build Latest.

    Note

    The build process may take some time. You can track progress in the Build Details pane. Once complete, the build status changes to Success.

Now that you have built the component, it's time to deploy the mcp server.

Step 3: Deploy

  1. In the left navigation menu, click Deploy.
  2. On the Set Up card, click Configure & Deploy.

  3. In the Environment Configurations pane, click Add a Configuration and add following environment variables in the table. Then tick Mark as a Secret and save the configuration by clicking Next button.

    Name Value
    GITHUB_PERSONAL_ACCESS_TOKEN YOUR GITHUB PAT

  4. In the File Mount pane, click Next to skip this step.

  5. Review the Endpoint Details and click Deploy.

    Note

    Deploying the service component may take some time. Once deployed, the Development environment card indicates the Deployment Status as Active.

Once you have successfully deployed the service, you can test your server. You can view the invoke URL details from the Test tab in left navigation menu.

Info

The path for SSE subscription is /sse, and the path for messages is /messages.