BHFDSC CVD-COVID TRE Dashboard MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
BHFDSC CVD-COVID TRE Dashboard MCP Server
An interactive MCP (Model Context Protocol) server for exploring the BHFDSC CVD-COVID TRE Dashboard data. This server provides tools with interactive UI widgets for exploring datasets across England, Scotland, and Wales.
Features
Dataset Picker - Interactive picker to explore TRE datasets with filtering by nation, group, and search terms
Data Explorer - Detailed exploration of specific datasets including overview, coverage, completeness, and data dictionary
Coverage Charts - Interactive bar charts visualizing data coverage across nations and datasets
Completeness Charts - Interactive bar charts visualizing data completeness across nations and datasets
Data Dictionary Explorer - Explore SDE data dictionary with field descriptions, types, and search
Summary Statistics - Overview statistics across all datasets and nations
Related MCP server: EOSC Data Commons Search
Data Sources
The server loads data from the BHFDSC/cvd-covid-tre-dashboard repository:
TRE Dataset Link - Metadata for 117 datasets across England, Scotland, and Wales
England Data - Overall, coverage, and completeness data (195 datasets)
Scotland Data - Overview, coverage, and completeness data (15 datasets)
Wales (SAIL) Data - Overview, coverage, and completeness data (24 datasets)
Data Dictionaries - DD_Scotland.xlsx, DD_Wales.xlsx, and SDE Data Dictionary (65 datasets)
Quick Start
Prerequisites
Python 3.10+
pip
Installation
# Clone the repository
git clone <this-repo>
cd bhfdscdashboardMCP
# Create virtual environment
python3 -m venv venv
source venv/bin/activate
# Install in development mode
pip install -e .Running the Server
# Start the server
python mcp_server.pyThe server will start on http://0.0.0.0:8000/mcp and load all data from GitHub on startup.
Health Check
curl http://localhost:8000/healthAvailable Tools
pick_dataset
Interactive picker for TRE datasets across England, Scotland, and Wales.
Parameters:
nation(optional): Filter by nation - "England", "Scotland", "Wales", or "All"group(optional): Filter by group (e.g., "Primary", "Secondary Care")search(optional): Search term for dataset title/description
Returns: Dataset metadata with interactive UI widget
explore_dataset
Detailed exploration of a specific dataset.
Parameters:
dataset_name: Name of the dataset to explorenation: Nation the dataset belongs to ("England", "Scotland", "Wales")
Returns: Overview, coverage, completeness, and data dictionary with interactive UI widget
view_coverage
Interactive coverage charts for datasets across nations.
Parameters:
nation(optional): Filter by nationdataset(optional): Specific dataset to view
Returns: Coverage data with interactive chart widget
view_completeness
Interactive completeness charts for datasets across nations.
Parameters:
nation(optional): Filter by nationdataset(optional): Specific dataset to view
Returns: Completeness data with interactive chart widget
explore_data_dictionary
Explore the SDE data dictionary for specific datasets.
Parameters:
dataset: Dataset name from SDE data dictionarysearch(optional): Search term for field names/descriptions
Returns: Data dictionary with interactive table widget
get_summary_stats
Get summary statistics across all datasets and nations.
Parameters: None
Returns: Statistics with interactive UI widget
Available Resources (Widgets)
ui://widgets/dataset-picker.html- Dataset picker widgetui://widgets/data-explorer.html- Data explorer widgetui://widgets/coverage-chart.html- Coverage chart widgetui://widgets/completeness-chart.html- Completeness chart widgetui://widgets/data-dictionary.html- Data dictionary widget
Configuration
Environment variables:
HOST- Server host (default: "0.0.0.0")PORT- Server port (default: 8000)MCP_ALLOWED_HOSTS- Comma-separated allowed hosts for DNS rebinding protectionMCP_ALLOWED_ORIGINS- Comma-separated allowed originsMCP_ENABLE_DNS_REBINDING_PROTECTION- Enable/disable DNS rebinding protection (default: true)
Deployment on Render
# render.yaml
services:
- type: web
name: bhfdsc-tre-dashboard-mcp
env: python
buildCommand: pip install -e .
startCommand: python mcp_server.py
envVars:
- key: MCP_ALLOWED_HOSTS
value: "*.onrender.com,localhost:*,127.0.0.1:*"
- key: MCP_ALLOWED_ORIGINS
value: "https://*.onrender.com"Testing with MCP Inspector
# Install MCP Inspector
npm install -g @modelcontextprotocol/inspector
# Run inspector against local server
npx @modelcontextprotocol/inspector http://localhost:8000/mcpExample Usage
# Using the MCP client
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
async with streamablehttp_client("http://localhost:8000/mcp") as (read, write):
async with ClientSession(read, write) as session:
# Initialize
await session.initialize()
# Pick datasets from England
result = await session.call_tool("pick_dataset", {"nation": "England"})
# Explore a specific dataset
result = await session.call_tool("explore_dataset", {
"dataset_name": "gdppr",
"nation": "England"
})
# View coverage charts
result = await session.call_tool("view_coverage", {"nation": "All"})
# Get summary stats
result = await session.call_tool("get_summary_stats", {})Project Structure
bhfdscdashboardMCP/
├── mcp_server.py # Main MCP server
├── pyproject.toml # Project configuration
├── widgets/ # Interactive UI widgets
│ ├── dataset_picker.html
│ ├── data_explorer.html
│ ├── coverage_chart.html
│ ├── completeness_chart.html
│ └── data_dictionary.html
├── venv/ # Virtual environment (gitignored)
└── README.md # This fileLicense
MIT License - See LICENSE file for details.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
List datasets, schemas, run APL queries, and use prompts for exploration, anomalies, and monitoring.
Search, sample and query open reproducible datasets published as immutable Parquet with schemas.
Query UK Parliament, elections, crime stats, ONS census data, and national archives
UK Office for National Statistics dataset catalogue + Beta JSON API
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with the Hugging Face Dataset Viewer API, allowing users to browse, search, filter, and analyze datasets hosted on the Hugging Face Hub.831MIT
- AlicenseNot gradedqualityBmaintenanceEnables natural language search and discovery of open-access scientific datasets through the EOSC Data Commons OpenSearch service. Provides tools to search datasets and retrieve file metadata using LLM-assisted queries.15MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to query NHS public health datasets, including prescribing data, dataset exploration, and organisation lookup via the NHSBSA Open Data Portal.9MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to search, query, and analyze CMS healthcare datasets from data.cms.gov, supporting features like dataset discovery, filtering, and CSV download for large-scale analysis.52MIT