covid

This MCP server provides a tool named getCovidStatsByCountry that fetches COVID-19 statistics for a specified country by querying the disease.sh API. Once the server is running and connected to an MCP host (for example Claude Desktop), you can invoke getCovidStatsByCountry to retrieve up-to-date pandemic data such as total cases, deaths, recovered counts, and per-country trends. The server acts as a bridge between the MCP host and the external disease.sh service, translating host requests into API calls and returning structured results back to the host.

Prerequisites:

• Node.js (recommended v14+)
• npm (comes with Node.js)

Install and run:

# 1) Clone the repository
git clone https://github.com/aarushkx/covid-mcp-server.git
cd covid-mcp-server

# 2) Install dependencies
npm install

# 3) Run the MCP server (default message bus port and host may vary)
PORT=3000 node server.js

Notes:

• If you publish or deploy to a hosting environment, ensure the PORT and base API URL are set via environment variables (PORT and DISEASE_API_BASE).
• If you have a custom startup script, you can replace the command with your preferred runner, e.g., npm start or a PM2 process, as long as it starts node server.js.

Tips:

• Ensure network access to the disease.sh API from your hosting environment.
• Set DISEASE_API_BASE to override the default API base if needed for testing or proxy setups.
• If you encounter rate limiting, consider caching results or increasing the request interval on the MCP host side.
• When integrating with an MCP host, verify the getCovidStatsByCountry tool signature matches the host expectations (country code/name as input).