Installation¶
Quick install¶
pip install scvi-tools-mcp
or with uvx (no install needed, runs directly):
uvx scvi-tools-mcp
MCP client configuration¶
Claude Desktop¶
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"scvi-tools": {
"command": "uvx",
"args": ["scvi-tools-mcp"]
}
}
}
Claude Code (CLI)¶
claude mcp add scvi-tools-mcp uvx scvi-tools-mcp -s user
Cursor / other MCP clients¶
{ "command": "uvx", "args": ["scvi-tools-mcp"] }
Optional: scvi-tools runtime¶
The server itself does not require scvi-tools. Install it only if you want to run the
knowledge refresh scripts locally:
pip install "scvi-tools-mcp[scvi]"
Development install¶
git clone https://github.com/Yoseflab/scvi-tools-mcp
cd scvi-tools-mcp
pip install -e ".[dev]"
pre-commit install
pytest
Requirements¶
Python ≥ 3.11
fastmcp ≥ 3.0
pydantic ≥ 2.0