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
- AsecurityAlicenseAqualityA server that bridges the Model Context Protocol (MCP) with SAP ABAP systems, allowing tools like Cline to retrieve ABAP source code, table structures, and other development artifacts.Last updated -135TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.Last updated -1TypeScriptMIT License
Semgrep MCP Serverofficial
AsecurityAlicenseAqualityAn MCP server that provides a comprehensive interface to Semgrep, enabling users to scan code for security vulnerabilities, create custom rules, and analyze scan results through the Model Context Protocol.Last updated -6168PythonMIT License- AsecurityFlicenseAqualityA template for building tools based on the Model Control Protocol (MCP) framework, providing a structured way to develop and integrate custom tools with Cursor.Last updated -2Python