Skip to main content

Creating Your First vMCP

This tutorial will guide you through creating your first vMCP that aggregates multiple MCP servers.

Prerequisites​

  • vMCP installed and running (see Installation)
  • At least one MCP server configured

Step 1: Navigate to vMCPs Page​

  1. Open http://localhost:8000 in your browser
  2. Click on "vMCPs" in the navigation menu

You'll see the vMCP management interface.

Step 2: Create a New vMCP​

Click the "Create vMCP" button. This opens the vMCP creation dialog.

Fill in Basic Information​

  • Name: Give your vMCP a descriptive name (e.g., "Development Tools")
  • Description: Explain what this vMCP is for (e.g., "Aggregates filesystem and git tools for development")

Step 3: Add MCP Servers​

In the "MCP Servers" section:

  1. Click "Add Server"
  2. Select an MCP server from the dropdown
  3. Set the priority (lower numbers = higher priority)
  4. Add more servers as needed

Example Configuration:

Server 1: filesystem (Priority: 1)
Server 2: github (Priority: 2)
Server 3: postgres (Priority: 3)

Understanding Priority​

When multiple servers provide the same tool name, vMCP uses priority to determine which one to call:

  • Priority 1 = Highest (called first)
  • Priority 2 = Second choice
  • Priority 3 = Third choice, etc.

Step 4: Configure Active Config (Optional)​

The "Active Config" section allows you to set runtime parameters that can be used with variable substitution.

Example:

{
  "default_repo": "myorg/myrepo",
  "api_key": "your-api-key",
  "workspace_path": "/home/user/projects"
}

These values can be referenced in tool calls using @config:key_name:

{
  "repo": "@config:default_repo"
}

Step 5: Save Your vMCP​

Click "Create" to save your vMCP.

You'll see your new vMCP appear in the list with:

  • Server count
  • Active status
  • Configuration indicator
  • Creation date

Step 6: Test Your vMCP​

View Available Tools​

  1. Click on your vMCP card
  2. In the dropdown menu, select "View Tools"
  3. You'll see all tools from all connected servers

Use with MCP Client​

Your vMCP is now available at:

mcp://localhost:8000/vmcps/{vmcp_id}

Configure your AI agent or MCP client to connect to this endpoint.

Example: Development vMCP​

Here's a complete example for local development:

Name: Development Tools

Description: Local development with filesystem, git, and documentation access

Servers:

  • filesystem (Priority: 1)
  • git (Priority: 2)
  • memory (Priority: 3)

Active Config:

{
  "workspace": "/home/user/projects/myapp",
  "default_branch": "main"
}

This vMCP gives your AI agent access to:

  • File operations (read, write, list)
  • Git operations (commit, push, pull)
  • Memory/context storage
  • All tools can reference the workspace path via @config:workspace

Next Steps​