convez.ai
MCP ServerDados & AnalyticsIntermediário
YosefLab

scvi-tools MCP Server

YosefLab/scvi-tools-mcp

Acesso estruturado à documentação scvi-tools via MCP para análise de single-cell omics

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que fornece acesso estruturado a documentação, tutoriais, API reference e workflows do scvi-tools para análise probabilística de dados de single-cell omics. Funciona como camada de conhecimento pura (sem execução de modelos) integrada a Claude, Cursor e clientes compatíveis com MCP.

Instalação

$npx convez-ai YosefLab/scvi-tools-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
1
Saúde
62%
Último commit
há 2 dias
Versão
v0.1.7
Issues abertas
0
Contribuidores
2

Casos de uso

  • Descobrir e selecionar modelos apropriados para sua análise de single-cell
  • Consultar parâmetros de configuração e setup de dados (AnnData) para modelos específicos
  • Buscar tutoriais e exemplos de workflows de análise de omics
  • Validar requisitos de dados antes de executar pipelines
  • Obter guias de análises downstream (DE, clustering, label transfer)

Veredito

Ferramenta especializada para pesquisadores de bioinformática trabalhando com single-cell omics. Oferece acesso sem-rede à documentação completa scvi-tools via MCP, eliminando necessidade de consultas manuais. Implementação sólida com refresh automático de conhecimento.

README

A tradução para o português deste README ainda está na fila.

scvi-tools-mcp

An MCP (Model Context Protocol) server that gives LLMs structured access to scvi-tools knowledge: model documentation, tutorials, API reference, workflow templates, and community FAQ.

No runtime model execution — pure knowledge layer. Works with Claude Desktop, Cursor, and any MCP-compatible client.


Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "scvi-tools": {
      "command": "uvx",
      "args": ["scvi-tools-mcp"]
    }
  }
}

Cursor / other clients

{ "command": "uvx", "args": ["scvi-tools-mcp"] }

Local install

pip install scvi-tools-mcp
scvi-tools-mcp

Tools

ToolDescription
recommend_modelRank models by task and data type — start here
get_model_overviewFull model description, use cases, inputs, outputs
get_model_parametersKey __init__ and train() parameters with defaults
get_setup_anndata_guideExact setup_anndata() call + required obs/var fields
validate_data_requirementsPass/fail checklist for your AnnData against a model
list_tutorialsBrowse tutorials by category
get_tutorialPaginated tutorial content (code + prose, no outputs)
search_tutorialsKeyword search across all tutorials
get_api_referenceSignature + docstring for any public class or function
search_apiSearch public symbols by keyword
get_workflow_templateStep-by-step code template for an analysis task
get_downstream_guideGuide for DE, clustering, embedding, label transfer
get_faqCurated FAQ from docs, GitHub issues, and Discourse
search_knowledgeCross-search all knowledge (catch-all)

Knowledge Sources

All knowledge is baked into the package as Markdown files at build time. No network calls at tool-call time.

DirectoryContent
knowledge/models/One .md per model — description, use case, parameters
knowledge/tutorials/60+ tutorials converted from .ipynb (code + prose only)
knowledge/api/Extracted class signatures and docstrings
knowledge/user_guide/Narrative documentation from the scvi-tools user guide
knowledge/faq/github_issues.mdTop GitHub issues snapshot
knowledge/faq/discourse_threads.mdDiscourse forum thread snapshot

Knowledge Refresh (CI)

Three monthly GitHub Actions jobs keep knowledge current — each opens a PR if a diff is found:

WorkflowScheduleWhat it does
refresh_knowledge.yaml1st of monthRe-scrapes GitHub issues + Discourse threads
sync_tutorials.yaml1st of monthFetches new .ipynb from scvi-tools, converts to .md
sync_model_knowledge.yaml1st of monthChecks CHANGELOG, regenerates model docs for changed models

All workflows also support workflow_dispatch for manual runs.


Development

git clone https://github.com/ori-kron-wis/scvi-tools-mcp
cd scvi-tools-mcp
pip install -e ".[dev]"
pytest

Rebuild knowledge manually

# Convert tutorials from a local scvi-tools checkout
python scripts/convert_notebooks.py /path/to/scvi-tools/docs/tutorials/notebooks \
    src/scvi_tools_mcp/knowledge/tutorials

# Extract API docs (requires scvi-tools installed)
pip install -e ".[scvi]"
python scripts/extract_api_docs.py

# Re-scrape external knowledge
python scripts/scrape_external.py

Adding a new model

  1. Run scripts/extract_api_docs.py after updating scvi-tools.
  2. Add the model name to MODEL_NAMES in src/scvi_tools_mcp/tools/_constants.py.
  3. Add requirements to MODEL_REQUIREMENTS in _data_prep.py if needed.

License

MIT

Ver o original no GitHub

Bom para

Relacionados