BioContextAI MCP Server Cookiecutter Template
Cookiecutter template for a Python-based biomedical MCP server with FastMCP. For more information about the BioContextAI project, please refer to https://biocontext.ai.
Usage
Use this template with cookiecutter by running:
uvx cookiecutter https://github.com/biocontext-ai/mcp-server-cookiecutter.git
Alternatively, you can also install cookiecutter with pip:
python3 -m pip install --user cookiecutter
cookiecutter https://github.com/biocontext-ai/mcp-server-cookiecutter.git
Publishing Your MCP Server
Python Package
We recommend that you publish your MCP server through PyPi so that it can be installed through uv and pip. The easiest way to do so, is to create a release on the GitHub repository of your MCP server and use the included release.yaml GitHub action. Make sure to add the repository and action as a trusted publisher in your PyPi account before releasing the first version.
With the setup of this cookiecutter, users will be able to simple run your MCP server with:
uvx your_package_name
To include it in one of various clients that supports the mcp.json standard, please use:
{
"mcpServers": {
"server-name": {
"command": "uvx",
"args": ["your_package_name"],
"env": {
"UV_PYTHON": "3.12" // or required version
}
}
}
}
Submit to BioContextAI
To make your MCP server discoverable to the community, please consider submitting it to the BioContextAI Registry. You can create the required metadata file easily through our online editor at: https://biocontext.ai/registry/editor. Once you have this file ready, simply open a pull request on the Registry repository. We will review your submission, include it in the Registry and announce it on social media.
You are also welcome to join our community within the scverse® Zulip to connect with users, developers and present your work.
Citation
If this template is useful to your research, please cite:
@article{BioContext_AI_Kuehl_Schaub_2025,
title={BioContextAI is a community hub for agentic biomedical systems},
url={http://dx.doi.org/10.1038/s41587-025-02900-9},
urldate = {2025-11-06},
doi={10.1038/s41587-025-02900-9},
year = {2025},
month = nov,
journal={Nature Biotechnology},
publisher={Springer Science and Business Media LLC},
author={Kuehl, Malte and Schaub, Darius P. and Carli, Francesco and Heumos, Lukas and Hellmig, Malte and Fernández-Zapata, Camila and Kaiser, Nico and Schaul, Jonathan and Kulaga, Anton and Usanov, Nikolay and Koutrouli, Mikaela and Ergen, Can and Palla, Giovanni and Krebs, Christian F. and Panzer, Ulf and Bonn, Stefan and Lobentanzer, Sebastian and Saez-Rodriguez, Julio and Puelles, Victor G.},
year={2025},
month=nov,
language={en},
}
