Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Hub Database Serversearch for servers related to weather data"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-demo
MCP server for querying MCP Hub database
Installation
# Create virtual environment
python3 -m venv venv
source venv/bin/activate
# Install dependencies
pip install -r requirements.txtConfiguration
Copy .env.example to .env and configure:
MCP_HUB_URL=http://localhost:8000/api/v1
VERIFY_SSL=trueRun Server
# HTTP mode (default)
python -m src.main
# stdio mode
TRANSPORT_MODE=stdio python -m src.mainServer runs on http://localhost:8080
Docker
# Build image
docker build -t mcp-hub-mcp .
# Run container (local)
docker run -d \
-p 8080:8080 \
-e MCP_HUB_URL=http://localhost:8000/api/v1 \
-e VERIFY_SSL=true \
--name mcp-hub-mcp \
mcp-hub-mcp
# Run container (production)
docker run -d \
-p 8080:8080 \
-e MCP_HUB_URL=https://your-domain:port/api \
-e VERIFY_SSL=false \
--name mcp-hub-mcp \
mcp-hub-mcp
# View logs
docker logs -f mcp-hub-mcp
# Stop and remove container
docker stop mcp-hub-mcp && docker rm mcp-hub-mcpTools
search_mcp_servers- Search for MCP servers by keywordlist_mcp_servers- List MCP servers with pagination and sortingget_mcp_server_details- Get detailed information about a specific serverget_top_servers- Get top servers by popularity or recencyget_top_contributors- Get top contributors
RooCode Setup
HTTP Mode
Add to RooCode MCP settings (cline_mcp_settings.json):
{
"mcpServers": {
"mcp-hub-mcp": {
"transport": {
"type": "sse",
"url": "http://localhost:8080/sse"
}
}
}
}stdio Mode
{
"mcpServers": {
"mcp-hub-mcp": {
"command": "python",
"args": ["-m", "src.main"],
"cwd": "/path/to/mcp-demo",
"env": {
"TRANSPORT_MODE": "stdio",
"MCP_HUB_URL": "http://localhost:8000/api/v1"
}
}
}
}Testing
Unit Tests (Mock-based, no backend required)
Fast tests using mocks. Can run without backend server.
# Run all unit tests
pytest tests/unit/ -v
# Run specific unit test file
pytest tests/unit/test_client.py -v
pytest tests/unit/test_handlers.py -v
pytest tests/unit/test_schemas.py -vIntegration Tests (Requires running backend)
Tests that call real API endpoints. Requires backend at http://localhost:8000.
# Run all integration tests
pytest tests/integration/ -v
# Run specific integration test
pytest tests/integration/test_client.py -vRun All Tests
# Run all tests (unit + integration)
pytest tests/ -v
# Run with coverage
pytest tests/ --cov=src --cov-report=htmlQuick Manual Test
# Test all 5 tools manually
python test_all_tools.py