diff --git a/deployment/MCP_SERVER_DEPLOYMENT.md b/deployment/MCP_SERVER_DEPLOYMENT.md index ca07e1a8de40..64aa2a082312 100644 --- a/deployment/MCP_SERVER_DEPLOYMENT.md +++ b/deployment/MCP_SERVER_DEPLOYMENT.md @@ -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 │ @@ -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 ``` @@ -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) @@ -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" } } } @@ -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() @@ -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. diff --git a/deployment/RELEASE_PROGRESS_DASHBOARD_DEPLOYMENT.md b/deployment/RELEASE_PROGRESS_DASHBOARD_DEPLOYMENT.md index d4a6285f6e13..c118e21e8f97 100644 --- a/deployment/RELEASE_PROGRESS_DASHBOARD_DEPLOYMENT.md +++ b/deployment/RELEASE_PROGRESS_DASHBOARD_DEPLOYMENT.md @@ -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**: @@ -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 @@ -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" @@ -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: @@ -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**: