freshcrate
Skin:/
Home > MCP Servers > ChatSpatial

ChatSpatial

🧬 Analyze spatial transcriptomics data through natural language conversation. Stop writing code, start having conversations with your data. MCP server for Claude Code and Codex.

Why this rank:Strong adoptionRecent releaseHealthy release cadence

Description

🧬 Analyze spatial transcriptomics data through natural language conversation. Stop writing code, start having conversations with your data. MCP server for Claude Code and Codex.

README

ChatSpatial

MCP server for spatial transcriptomics analysis via natural language

Paper MLGenX @ ICLR 2026 ENAR 2026 IBC 2026 CI PyPI Python 3.11-3.13 License: MIT Docs

ChatSpatial Overview

ChatSpatial replaces ad-hoc LLM code generation with schema-enforced orchestration. Instead of generating arbitrary scripts, the LLM selects tools and parameters from a curated registry, making spatial transcriptomics workflows more reproducible across sessions and clients.

It exposes 60+ spatial transcriptomics methods as MCP tools, so any MCP-compatible client can analyze data through natural language.


Start Here

  1. Install ChatSpatialInstallation Guide
  2. Configure your MCP clientConfiguration Guide
  3. Run your first analysisQuick Start

Minimal example prompt:

Load /absolute/path/to/spatial_data.h5ad and show me the tissue structure

ChatSpatial works with any MCP-compatible client — Claude Code, Claude Desktop, Codex, OpenCode, and other MCP-capable tools.


Capabilities

60+ methods across 11 categories. Supports 10x Visium, Xenium, Slide-seq v2, MERFISH, seqFISH.

Category Methods
Spatial Domains SpaGCN, STAGATE, GraphST, BANKSY, Leiden, Louvain
Deconvolution FlashDeconv, Cell2location, RCTD, DestVI, Stereoscope, SPOTlight, Tangram, CARD
Cell Communication LIANA+, CellPhoneDB, CellChat (cellchat_r), FastCCC
Cell Type Annotation Tangram, scANVI, CellAssign, mLLMCelltype, scType, SingleR
Differential Expression Wilcoxon, t-test, Logistic Regression, pyDESeq2
Trajectory & Velocity CellRank, Palantir, DPT, scVelo, VeloVI
Spatial Statistics Moran's I, Local Moran, Geary's C, Getis-Ord Gi*, Ripley's K, Co-occurrence, Neighborhood Enrichment, Centrality Scores, Local Join Count, Network Properties
Enrichment GSEA, ORA, Enrichr, ssGSEA, Spatial EnrichMap
Spatial Genes SpatialDE, SPARK-X, FlashS
Integration Harmony, BBKNN, Scanorama, scVI
Other CNV Analysis (InferCNVPy, Numbat), Spatial Registration (PASTE, STalign)

Documentation

Guide Owns
Installation Environment setup, package install, platform notes
Quick Start First successful analysis after setup
Concepts Method selection and analysis reasoning
Examples Prompt recipes and workflow examples
Configuration Exact MCP client configuration syntax
Troubleshooting Symptom → fix guidance
Methods Reference Canonical tool parameters and defaults
Full Docs Complete documentation site

Citation

If you use ChatSpatial in your research, please cite:

@article{Yang2026.02.26.708361,
  author = {Yang, Chen and Zhang, Xianyang and Chen, Jun},
  title = {ChatSpatial: Schema-Enforced Agentic Orchestration for Reproducible and Cross-Platform Spatial Transcriptomics},
  elocation-id = {2026.02.26.708361},
  year = {2026},
  doi = {10.64898/2026.02.26.708361},
  publisher = {Cold Spring Harbor Laboratory},
  URL = {https://www.biorxiv.org/content/early/2026/03/01/2026.02.26.708361},
  journal = {bioRxiv}
}

ChatSpatial orchestrates many excellent third-party methods. Please also cite the original tools your analysis used.


Contributing

Documentation improvements, bug reports, and new analysis methods are all welcome. See CONTRIBUTING.md.

MIT License · GitHub · Issues

Release History

VersionChangesUrgencyDate
v1.5.3**Full Changelog**: https://github.com/cafferychen777/ChatSpatial/compare/v1.5.2...v1.5.3Medium8/15/2026
v1.3.2**Full Changelog**: https://github.com/cafferychen777/ChatSpatial/compare/v1.3.1...v1.3.2High8/9/2026
v1.2.10**Full Changelog**: https://github.com/cafferychen777/ChatSpatial/compare/v1.2.8...v1.2.10High5/21/2026
v1.2.8**Full Changelog**: https://github.com/cafferychen777/ChatSpatial/compare/v1.2.7...v1.2.8High5/12/2026
v1.2.7**Full Changelog**: https://github.com/cafferychen777/ChatSpatial/compare/v1.2.6...v1.2.7High5/11/2026
v1.2.6**Full Changelog**: https://github.com/cafferychen777/ChatSpatial/compare/v1.2.5...v1.2.6High5/2/2026
v1.1.6## What's Changed * perf: memory/speed consistency improvements across core tools and wrappers by @cafferychen777 in https://github.com/cafferychen777/ChatSpatial/pull/19 **Full Changelog**: https://github.com/cafferychen777/ChatSpatial/commits/v1.1.6Low2/28/2026
v0.3.0-dataSample datasets for testing ChatSpatial functionality: 📊 **Included Datasets:** - **card_reference_filtered.h5ad**: Single-cell reference data (1,782 cells × 19,736 genes, 36MB) - 9 cell types including cancer clones and ductal cells - Pancreatic tissue from cancer research - **card_spatial.h5ad**: Spatial transcriptomics data (428 spots × 25,753 genes, 7.7MB) - Clear spatial domain structure (3 distinct regions) - Includes spatial coordinates 🎯 **Perfect for testing:** - ✅ SpatiaLow10/28/2025
v0.2.0-dataSample datasets for testing ChatSpatial functionality: 📊 **Included Datasets:** - **destvi_reference_small.h5ad**: Single-cell reference data (598 cells × 300 genes, 7.8MB) - **destvi_spatial_small.h5ad**: Spatial transcriptomics data (200 spots × 300 genes, 10MB) 🎯 **Perfect for testing:** - Spatial deconvolution with Cell2location/DestVI - Cell type annotation - Spatial domain identification - Cell communication analysis 📥 **Usage:** ```bash curl -L -o reference_data.h5ad https://githubLow9/23/2025
v0.2.0# 🧬 ChatSpatial MCP Server v0.2.0 **Production-ready Model Context Protocol server for spatial transcriptomics analysis** ## 🎯 **What's New** ### 📚 **Documentation & CI Improvements** - **FIXED**: All broken documentation links in README.md - **ALIGNED**: Feature descriptions with actual code implementation - **UPDATED**: Installation guides and dependency configuration - **ENHANCED**: CI workflow with Python 3.10/3.11 testing matrix - **IMPROVED**: Code quality checks and automated testinLow8/26/2025
v0.1.2**Full Changelog**: https://github.com/cafferychen777/ChatSpatial/compare/v0.1.0...v0.1.2Low8/26/2025
v0.1.1## 🚀 Release v0.1.1 ### 🛠 GitHub Actions Improvements - ✅ Fixed all GitHub Actions workflows - ✅ Resolved dependency resolution issues - ✅ Added minimal test workflow for quick validation - ✅ Improved CI/CD pipeline reliability ### 📊 Current Status All workflows now passing with **100% success rate**: - CI ✅ - Tests ✅ - Code Quality ✅ - ChatSpatial Test Suite ✅ - Minimal Test ✅ ### 🐛 Bug Fixes - Fixed missing `requirements.txt` references - Fixed `pip install` dependency resolution deptLow8/26/2025
v0.1.0## ChatSpatial v0.1.0 - Initial Release ### 🎉 Features **Core Functionality:** - Interactive spatial transcriptomics analysis through Model Context Protocol (MCP) - Support for multiple spatial data formats (10x Visium, Slide-seq, MERFISH, seqFISH) - Enhanced data preprocessing with user-controlled filtering and subsampling - Comprehensive spatial visualization capabilities **Advanced Analysis Methods:** - **GASTON Integration**: Deep learning-based spatial variable gene identification - **LLow6/19/2025

Dependencies & License Audit

Loading dependencies...

Similar Packages

wcgwShell and coding agent on mcp clients5.6.5
mcp-gateway-registryEnterprise-ready MCP Gateway & Registry that centralizes AI development tools with secure OAuth authentication, dynamic tool discovery, and unified access for both autonomous AI agents and AI coding a1.30.0
agentscopeBuild and run agents you can see, understand and trust.v2.0.8
OpenContractsHumans and AI agents, building knowledge bases together. Self-hosted document annotation, version control, semantic search, and MCP.v3.1.0
mcp-workspaceMCP Workspace Server: A secure Model Context Protocol server providing file, git, and GitHub tools for AI assistants within a sandboxed project directory.0.1.13

More in MCP Servers

difyProduction-ready platform for agentic workflow development.
tabularisA lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.
ai-agents-from-zero 🚀 2026 最系统的 AI Agent 速成指南|智能体实战教程 · 完整学习路径 + 实战项目 + 面试题库 · 对标大模型应用开发工程师岗位 · 覆盖LangChain / LangGraph / Coze / Dify / MCP / skills / LLM / RAG / 提示词 · 企业级部署与微调 · 从0到企业级落地 + 从学习到上线项目 + 面试准备一体化
studioOpen-source control plane for your AI agents. Connect tools, hire agents, track every token and dollar