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 Server 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 already installed in the project
• Docker Hub: Searches for available servers on Docker Hub
• GitHub: Searches for available servers 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 related keywords of 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 features
• Docker Hub/GitHub Information: Author, Docker image, repository
• Links: Links to the repository and Dockerfile
• Environment Variables: List of required (mandatory and optional) variables
• Command: Command needed 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 mandatory variable:
   • Fill in the required 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 (mandatory and secret)

Step 6: Install the Server

1. Review all configurations
2. Ensure that all mandatory 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 available tools 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 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 be automatically filled based on the JSON
5. Review and adjust the settings
6. Click 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 available tools in each installed server

Tips

• Always review the server documentation before installation
• 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