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.pyThis server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.