MCP server for the Ersilia Model Hub

A Model Context Protocol server built on the official FastMCP SDK. It lets MCP clients search the Ersilia Model Hub catalog and fetch, serve, and run its AI/ML models, all over stdio.

A typical workflow is search_model → fetch_model → serve_model → predict → close_model. You can optionally call generate_inputs after serving to sample example inputs to feed into predict, and delete_model to remove the model from local storage.

Installation

Ensure you have the following installed:

• conda (miniconda is fine)
• Docker
• git

Clone the repository locally using git:

git clone git@github.com:ersilia-os/ersilia-mcp.git

Create a new virtual conda environment, activate it, and install the necessary packages:

conda create -n ersilia-mcp python=3.12
conda activate ersilia-mcp
pip install poetry
poetry config virtualenvs.create false --local
poetry env use $(which python)
poetry install

Client Setup & Registration

This MCP server has been tested mainly on Claude (specifically using Claude Code), but it supports any Model Context Protocol (MCP) host or model provider (such as Gemini or ChatGPT) that supports local stdio MCP servers.

Note on Claude Code: This repository is set up to be automatically configured with Claude Code out of the box. It includes a project-scoped .mcp.json configuration file so that when you run Claude Code in this workspace, the Ersilia MCP server is registered and started automatically.

Currently, we only have dedicated setup and registration documentation for:

• Claude Code Setup Guide
• Gemini Setup Guide

We would love to receive documentation updates and setup guides for other MCP clients and platforms. If you have successfully set up this server with another client, please consider adding a new setup guide to docs/mcp_setup/! See CONTRIBUTING.md for contribution guidelines.

For further details on manual registration, debugging, or full development setup, please see DEVELOPMENT.md.

About the Ersilia Open Source Initiative

The Ersilia Open Source Initiative is a tech-nonprofit organization fueling sustainable research in the Global South. Ersilia's main asset is the Ersilia Model Hub, an open-source repository of AI/ML models for antimicrobial drug discovery.