How to Install an MCP Server

This guide explains how to install MCP servers on the Aumo platform, whether from Docker Hub or GitHub.

Overview

Installing an MCP server involves:

1. Finding the server: Locate the desired server on Docker Hub or GitHub
2. Reviewing information: Check description, requirements, and environment variables
3. Configuring variables: Set the necessary environment variables
4. Installing: Confirm and install the server

Step 1: Access the MCP Servers Page

1. Navigate to the Projects section in the side menu
2. Select the desired project
3. Click on MCP Servers in the project's side menu

Step 2: Choose the Source

On the MCP Servers screen, you will see three tabs:

• Installed: Shows servers that are already installed in the project
• Docker Hub: Searches for servers available on Docker Hub
• GitHub: Searches for servers available on GitHub

Select the tab corresponding to the desired source.

Step 3: Find the Server

1. Use the search bar to find the desired server
2. Type the name or keywords related to the server
3. Review the displayed results

Searching on Docker Hub

The servers from Docker Hub are displayed in cards, each showing:

• Server name
• Brief description
• Status (Available)
• "Install" button

Searching on GitHub

The servers from GitHub are also displayed in similar cards, showing:

• Server name
• Repository description
• Status (Available)
• "Install" button

Step 4: Review Server Details

Before installing, click on the server card to see detailed information:

The details modal shows:

• Description: Complete description of the server and its functionalities
• Docker Hub/GitHub Information: Author, Docker image, repository
• Links: Links to the repository and Dockerfile
• Environment Variables: List of necessary variables (required and optional)
• Command: Command required to run the server

Step 5: Configure Environment Variables

Many MCP servers require environment variables to function:

1. In the installation modal, review the Environment Variables section
2. For each required variable:
   • Fill in the necessary value
   • Variables marked as "Secret" will be hidden after saving
3. Optional variables can be left blank if not needed

Example: Installing Brave Search

For the Brave Search server, you will need to configure:

• BRAVE_MCP_TRANSPORT: Usually "stdio" (default value)
• BRAVE_API_KEY: Your Brave Search API key (required and secret)

Step 6: Install the Server

1. Review all configurations
2. Ensure all required variables are filled in
3. Click the Install button
4. Wait for the installation confirmation

Step 7: Verify Installation

After installation:

1. The server will appear in the Installed tab
2. The status will be displayed as "Active"
3. You will be able to see the tools available on the server
4. The server will be available for use in assistants

Creating an MCP Server via JSON

You can also create MCP servers manually using JSON:

1. Click on the + New MCP Server button
2. In the modal, you will see the option "Batch Creation or JSON Template"
3. Paste a valid JSON in the format:

{
  "mcpServers": {
    "server-name": {
      "command": "command",
      "args": ["arg1", "arg2"],
      "env": {
        "VARIABLE": "value"
      }
    }
  }
}

4. The form will automatically load based on the JSON
5. Review and adjust the configurations
6. Click on Add Servers

Next Steps

After installing an MCP server:

• Manage MCP Servers: Learn to manage installed servers
• Use MCP in Assistants: Integrate MCP servers into your assistants
• Explore the tools available in each installed server

Tips

• Always review the server documentation before installing
• Keep API keys secure (secret variables)
• Test servers in development projects before using them in production
• Some servers may have usage limits or associated costs