Skip to content

Update MCP deployment guide for HTTP transport #853

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rioliu-rh merged 2 commits into from
Dec 23, 2025
Merged

Update MCP deployment guide for HTTP transport #853

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ffcccca
Update MCP deployment guide for HTTP transport migration
rioliu-rh Dec 23, 2025
568f499
Update dashboard deployment guide for HTTP transport migration
rioliu-rh Dec 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 13 additions & 13 deletions deployment/MCP_SERVER_DEPLOYMENT.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ This guide explains how to deploy the Release Tests MCP server on your VM for re
## Architecture

```
┌─────────────────┐ HTTP/SSE ┌─────────────────┐
┌─────────────────┐ HTTP ┌─────────────────┐
│ Your Laptop │◄─────────────────────────►│ VM Server │
│ - Claude Code │ http://vm-hostname:8000 │ - OAR CLI │
│ - Other AI │ │ - Credentials │
Expand Down Expand Up @@ -71,7 +71,7 @@ python3 -m mcp.server
You should see:
```
INFO - Starting Release Tests MCP Server
INFO - Transport: SSE (HTTP)
INFO - Transport: streamable-http
INFO - Running on http://127.0.0.1:8000
```

Expand All @@ -81,10 +81,10 @@ Edit `mcp_server/server.py` and change the last line:

```python
# Change from:
mcp.run(transport="sse")
mcp.run(transport="streamable-http")

# To (listen on all interfaces):
mcp.run(transport="sse", sse_params={"host": "0.0.0.0", "port": 8080})
mcp.run(transport="streamable-http", host="0.0.0.0", port=8080)
```

### 5. Configure Firewall (If Needed)
Expand Down Expand Up @@ -190,8 +190,8 @@ Add to your Claude Code MCP settings:
{
"mcpServers": {
"release-tests": {
"transport": "sse",
"url": "http://your-vm-hostname.redhat.com:8080/sse"
"type": "http",
"url": "http://your-vm-hostname.redhat.com:8080/mcp"
}
}
}
Expand All @@ -203,11 +203,11 @@ Add to your Claude Code MCP settings:

```python
from mcp import ClientSession
from mcp.client.sse import sse_client
from mcp.client.streamable_http import streamable_http_client

async with sse_client(
url="http://your-vm-hostname.redhat.com:8080/sse"
) as (read, write):
async with streamable_http_client(
url="http://your-vm-hostname.redhat.com:8080/mcp"
) as (read, write, _):
async with ClientSession(read, write) as session:
# List available tools
tools = await session.list_tools()
Expand All @@ -227,16 +227,16 @@ async with sse_client(

```bash
# On the VM
curl http://localhost:8080/sse
curl http://localhost:8080/mcp
```

Should return SSE stream or connection info.
Should return MCP connection info or server metadata.

### 2. Test from Your Laptop (Remote)

```bash
# On your laptop
curl http://your-vm-hostname.redhat.com:8080/sse
curl http://your-vm-hostname.redhat.com:8080/mcp
```

Should also connect successfully.
Expand Down
12 changes: 6 additions & 6 deletions deployment/RELEASE_PROGRESS_DASHBOARD_DEPLOYMENT.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ This guide covers deploying the Release Progress Dashboard as a systemd service
2. **Environment Variables** (in `~/.bash_profile` or `~/.bashrc`):
```bash
# Optional: MCP server URL (defaults to localhost:8000)
export MCP_SERVER_URL="http://localhost:8000/sse" # Or remote MCP server URL
export MCP_SERVER_URL="http://localhost:8000/mcp" # Or remote MCP server URL
```

3. **Dependencies**:
Expand All @@ -25,7 +25,7 @@ This guide covers deploying the Release Progress Dashboard as a systemd service
4. **MCP Server**:
- The dashboard requires the MCP server to be running
- See `MCP_SERVER_DEPLOYMENT.md` for MCP server deployment
- Default MCP server URL: `http://localhost:8000/sse`
- Default MCP server URL: `http://localhost:8000/mcp`

## Installation Steps

Expand Down Expand Up @@ -55,7 +55,7 @@ WorkingDirectory=/home/your-username/release-tests
ExecStart=/bin/bash -l -c 'cd /home/your-username/release-tests && ...'

# Optional: Customize MCP server URL if using remote server
Environment="MCP_SERVER_URL=http://your-mcp-server:8000/sse"
Environment="MCP_SERVER_URL=http://your-mcp-server:8000/mcp"

# Optional: Change dashboard port (default: 8501)
Environment="STREAMLIT_SERVER_PORT=8501"
Expand Down Expand Up @@ -164,7 +164,7 @@ The service can optionally use environment variables from the user's `.bash_prof
# ~/.bash_profile or ~/.bashrc

# MCP server URL (optional, defaults to localhost:8000)
export MCP_SERVER_URL="http://localhost:8000/sse"
export MCP_SERVER_URL="http://localhost:8000/mcp"
```

After modifying environment variables, restart the service:
Expand Down Expand Up @@ -227,13 +227,13 @@ sudo journalctl -u release-progress-dashboard.service -n 50
sudo systemctl status release-tests-mcp.service

# Test MCP server endpoint
curl http://localhost:8000/sse
curl http://localhost:8000/mcp
```

**Check network connectivity**:
```bash
# If using remote MCP server
curl http://your-mcp-server:8000/sse
curl http://your-mcp-server:8000/mcp
```

**Review dashboard logs**:
Expand Down