Installation Guide

Installation Guide

This guide will walk you through the process of installing and running MCP Catie.

Prerequisites

Before you begin, ensure you have the following:

• Go 1.18 or higher (for building from source)
• Docker (optional, for containerized deployment)
• Basic understanding of MCP and JSON-RPC

Option 1: Building from Source

1. Clone the repository

git clone https://github.com/mclenhard/mcp-router-proxy.git
cd mcp-router-proxy

2. Build the application

go build -o mcp-catie ./cmd/main.go

3. Create a configuration file

Create a router_config.yaml file in the project directory. See the Configuration section for details.

4. Run the application

./mcp-catie

By default, the service will listen on port 80. You can change this by setting the PORT environment variable:

PORT=8080 ./mcp-catie

Option 2: Using Docker

1. Pull the Docker image (or build it yourself)

docker pull mclenhard/mcp-catie:latest

Alternatively, build the image locally:

docker build -t mcp-catie .

2. Create a configuration file

Create a router_config.yaml file as described in the Configuration section.

3. Run the container

docker run -p 80:80 -v $(pwd)/router_config.yaml:/root/router_config.yaml mclenhard/mcp-catie:latest

This command:

• Maps port 80 in the container to port 80 on your host
• Mounts your local configuration file into the container

Verifying the Installation

Once the service is running, you can verify it's working by:

1. Checking the health endpoint

curl http://localhost:80/health

You should receive a 200 OK response.

2. Viewing the monitoring UI

Open http://localhost:80/stats in your browser. You'll need to enter the username and password specified in your configuration file.

Next Steps

Now that you have MCP Catie installed, proceed to the Configuration section to learn how to set up routing rules for your MCP services.