Allows running the SAMtools MCP server within a Docker container, providing isolated execution of genomic analysis tools and simplified deployment with volume mounting for BAM file processing.
Enables installation of the SAMtools MCP through Git repository cloning, facilitating access to the source code for customization and development.
Provides a Python interface for programmatically interacting with SAMtools functionality, allowing scripted operations on genomic data files.
SAMtools MCP (Model Control Protocol)
A Model Control Protocol implementation for SAMtools, providing a standardized interface for working with SAM/BAM/CRAM files.
Features
- View and convert SAM/BAM/CRAM files
- Sort alignment files
- Index BAM/CRAM files
- Generate statistics
- Merge multiple BAM files
- Calculate read depth
- Index FASTA files
- And more...
Core Capabilities
- File Format Support: Handle SAM (text), BAM (binary), and CRAM (compressed) alignment files
- Format Conversion: Convert between SAM, BAM, and CRAM formats seamlessly
- Region-Specific Analysis: Extract and analyze specific genomic regions
- Flag-Based Filtering: Filter reads based on SAM flags
- Performance Optimization: Multi-threaded operations for sorting and merging
- Statistical Analysis: Generate comprehensive alignment statistics
Tools Overview
Tool | Description | Key Features |
---|---|---|
view | View and convert alignment files | - Format conversion (SAM/BAM/CRAM)- Region filtering- Flag-based filtering- Header manipulation |
sort | Sort alignment files | - Coordinate-based sorting- Name-based sorting- Memory per thread control- Multi-threading support |
index | Index BAM/CRAM files | - BAI index generation- CSI index support- CRAM index creation |
merge | Merge multiple BAM/CRAM files | - Multi-file merging- Thread-enabled processing- Header reconciliation |
depth | Calculate read depth | - Per-base depth calculation- Region-specific analysis- Multi-file support |
flagstat | Generate alignment statistics | - Comprehensive flag statistics- Quality checks- Paired-end metrics |
idxstats | BAM/CRAM index statistics | - Reference sequence stats- Mapped/unmapped counts- Length information |
faidx | Index FASTA files | - FASTA indexing- Region extraction- Sequence retrieval |
Installation
Using Docker (Recommended)
The easiest way to use SAMtools MCP is through Docker:
Local Installation
- Clone the repository:
- Install dependencies:
Configuration
MCP Server Configuration
To configure the MCP server to use the Docker image, add the following to your MCP configuration file:
Local MCP Configuration
To configure the MCP to run using uv
, add the following to your ~/.cursor/mcp.json
:
Replace /path/to/samtools_mcp.py
with the actual path to your samtools_mcp.py
file.
Usage
Basic Commands
- View BAM file:
- Sort BAM file:
- Index BAM file:
Advanced Usage
- View specific region with flags:
- Sort by read name:
- Calculate depth with multiple input files:
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Model Control Protocol implementation for SAMtools, providing a standardized interface for working with SAM/BAM/CRAM files.
Related MCP Servers
- -securityAlicense-qualityA comprehensive toolkit that enhances LLM capabilities through the Model Context Protocol, allowing LLMs to interact with external services including command-line operations, file management, Figma integration, and audio processing.Last updated -22PythonApache 2.0
- AsecurityAlicenseAqualityA Model Control Protocol server that provides access to nmap network scanning functionality, allowing users to run customizable scans, store results, and analyze network security using AI prompts.Last updated -38PythonMIT License
- AsecurityAlicenseAqualityA bridge between iOS simulators and the Model Context Protocol, enabling programmatic control of iOS simulators through standardized communication interfaces.Last updated -1230TypeScriptMIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that creates tools from API configurations defined in YAML files, allowing easy integration of external APIs into an MCP ecosystem without coding.Last updated -786TypeScript