OneKGPd-MCP
About
Real-time access to 1000 Genomes Project dataset
Details
- Author
- dnaerys
- Categories
- Other, Database
Jump to
Setup
Install OneKGPd-MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/dnaerys/OneKGPd-MCP
Follow the installation instructions in the repository README, then restart your MCP client.
Natural language access to1000 Genomes Project dataset, hosted online inDnaerys variant store
Sequenced & aligned byNew York Genome Center(GRCh38).3202 samples: 2504 unrelated samples from phase three panel + 698 samples from 602 family trios -dataset details
-
real-timeaccess to138 044 723unique variants and~442 billionindividual genotypes
variant, sample and genotype selection based on coordinates, annotations, zygosity, population
filtering by VEP (impact, biotype, feature type, variant class, consequences), ClinVar Clinical Significance (202502), gnomADe + gnomADg 4.1, AlphaMissense Score & AlphaMissense Class annotations
- annotated with VEP 115 / GENCODE 49
- GENCODE Primary settranscripts
- full annotation composition
returned variants annotated withHGVSp,gnomADe + gnomADg,AlphaMissense score+ cohort-wide statistics
- HGVSpannotations are forCanonical transcriptsto reduce LLMs cognitive load
samples annotated with:familyId, gender, paternalId, maternalId, relationship, children, population, superpopulation, phase3 indicator
- http://db.dnaerys.org/mcp
- https://db.dnaerys.org/mcp
Treat the 26S Proteasome as a mechanically redundant 3D machine and map every missense variant from the KGP individuals across all 33 subunits. Perform a spatial analysis to determine if pathogenic variation is statistically partitioned toward the distal 'Lid' (Zone C) rather than the more evolutionary constrained 'Core' (Zone A) or 'Gating' (Zone B) interfaces. Identify individuals with a high cumulative burden (2+ 'Likely Pathogenic' variants) to investigate inter-subunit compensation, searching for paired 'weakening' and 'stabilizing' mutations at protein-protein hinges. Finally, define the 'mechanical tolerance' of the proteasome by establishing the maximum cumulative structural disruption observed in a single healthy individual based on AlphaMissense scores and calculated ΔΔG values.
Case study: workflow, task reports, manuscripts drafts →
The MCM2-7 Complex (The "DNA Helicase Motor") is a molecular masterpiece. It’s a heterohexameric ring where each subunit is a distinct "gear" in the DNA-unzipping motor. Unlike homomeric rings (where every subunit is the same), this complex is asymmetric. Each interface between subunits is unique, and they don't all burn ATP at the same rate. The MCM2/5 interface is the "gate" that must physically open to allow DNA to enter the ring and then snap shut. This is a high-stress mechanical point.
Identify individuals in the KGP cohort carrying missense variants at the MCM2/5 interface. Specifically, look for 'charge-reversal' variants (e.g., Aspartate to Lysine). In these specific samples, analyze the 'compensatory coupling': do they carry a secondary, reciprocal charge-reversal variant on the opposing subunit interface that restores the electrostatic 'latch' ?
Identify individuals in the KGP cohort who carry high-pathogenicity variants in the Walker A or Walker B motifs (the ATP-burning heart) of any MCM subunit in MCM2-7 Complex. For these individuals, perform a 'Systemic Flux' analysis: look at their variants in the leading-strand polymerase (POLE) and the sliding clamp (PCNA). Do you detect a signature of 'Coordinated Deceleration' where the motor, the clamp, and the polymerase all carry variants that suggest a slower but highly-accurate replication fork ?
The human RNA Exosome (Exo-9 core) is a "dead machine" that acts as a scaffold. In lower organisms the ring itself can degrade RNA. In humans, the 9-subunit ring has lost all its catalytic teeth and is purely a structural tunnel that guides RNA into the catalytic subunits (DIS3 or EXOSC10) attached at the bottom. Since RNA is a highly negatively charged polymer, the residues lining this pore are typically positively charged (Lysine, Arginine), but not too "sticky" or RNA will jam. So, to reach the "shredder" at the bottom it must slide through a narrow pore formed by the Exo-9 ring.
The task: analyse all missense variants in the KGP cohort that map to the internal pore-lining residues of the Exo-9 ring. Look for 'charge-swap' variants where a positive residue (K, R) is replaced by a negative one (D, E). If an individual is healthy despite having a 'negative patch' in the tunnel that should repel RNA, do they carry a compensatory variant in the cap subunits (EXOSC1, 2, 3) that widens the entrance? Use a 3D electrostatic surface map to determine if the 'healthy' cohort maintains a specific electrostatic gradient.
Synergistic Epistasis in Redox Homeostasis
Cellular redox homeostasis is maintained by two parallel antioxidant systems: the glutathione system and the thioredoxin system. Complete loss of either GSR or TXNRD1 is incompatible with mammalian development, yet population databases contain individuals carrying variants predicted to impair enzyme function.
Identify clusters of individuals in the KGP cohort who carry multiple 'Moderate' impact VEP variants across both systems. Reasoning through the AlphaMissense structural implications, can you detect a 'balancing act' where a loss of efficiency in Glutathione reductase is consistently paired with high-confidence benign or potentially activating variants in the Thioredoxin system ? Synthesize a model of 'Redox Robustness' based on the co-occurrence of these variants across the cohort.
Implemented as a Java EE service, accessingKGP datasetvia gRPC calls to public Dnaerys variant store service.
-
provides MCP overStreamable HTTP,HTTP/SSEandSTDIOtransports
service implementation is based onQuarkus MCP Server framework
sample population and metadata are managed by an embedded DuckDB instance
- Genomics database:findVariants, findVariantsInSamples, findSamples, findSamplesHomozygousReference, getDatasetInfo, getKinshipDegree, computeAlphaMissenseAvg, computeVariantBurden
- Population and metadata:listPopulations, listSuperpopulations, getPopulationStats, getSuperpopulationSummary, getSampleMetadata, findSamplesByPopulation
- implementation
Project can be run locally with MCP overstdioand/orhttptransports
- build the project and package it as a singleüber-jar:
- jar is located intarget/onekgpd-mcp-runner.jarand includes all dependencies
./mvnw clean package -DskipTests -Dquarkus.package.jar.type=uber-jar
./mvnw clean package -Dmaven.test.skip=true -Dquarkus.package.jar.type=uber-jar
- run it locally withdev profile
- bothstdioandhttptransports are enabled
- http transport is on port 9000 (quarkus.http.port in config)
- project expectsJRE 21to be available at runtime
java -Dquarkus.profile=dev -jar <full path>/onekgpd-mcp-runner.jar
-
to connect viahttptransport,remote or local, simply direct the client to a destination,e.g.http://localhost:9000/mcporhttps://db.dnaerys.org:443/mcp
- NB:Claude Desktopwon't work withhttp://localhost:9000/mcpoption. This option is for clients likeGoose.
to connect viastdiotransport, MCP client should start application withdev profileand with a full path to the jar file
- e.g. forClaude Desktopadd to config files (e.g.claude_desktop_config.json):
{ "mcpServers": { "OneKGPd": { "command": "java", "args": ["-Dquarkus.profile=dev", "-jar", "/full/path/onekgpd-mcp-runner.jar"] } } }
How many variants exist in 1000 Genome Project ?
- Unit tests: 399 (7 disabled, 392 passing)
- Integration tests: 11 (1 disabled, 10 passing)
- 7 DnaerysClient unit tests (PaginationTests, streaming gRPC limitation -wiremock-grpc-extension:0.11.0cannot mock streaming RPCs yet)
- 1 DnaerysClient integration test (PaginationLogicTests, streaming gRPC limitation -wiremock-grpc-extension:0.11.0cannot mock streaming RPCs yet)
# Unit tests only (no server required) ./mvnw test # Integration tests (requires db.dnaerys.org access) ./mvnw verify -DskipITs=false # Update test baselines after data changes ./mvnw verify -DskipITs=false -DupdateBaseline=true
Test part of this project is written by Claude. Fun part is written by humans.
- Issues and questions:https://github.com/dnaerys/onekgpd-mcp/issues
- Email:mcp@dnaerys.org
This project is licensed under the Apache License 2.0 - see theLICENSEfile for details.
Access and interact with Allen Institute for Neural Dynamics (AIND) metadata directly within your IDE.
A high-performance JavaScript server for the Alliance of Genome Resources (AGR) MCP.
Access the AlphaFold Protein Structure Database for protein structure prediction and analysis.
Interface with Biomart, a biological data query tool, using the pybiomart Python package.
Agent-first rewrite of genomeoncology's BioMCP in TypeScript to provide next-gen biomedical data access for agents.
Perform complex queries on the DANDI Archive, a platform for neurophysiology data.
Interact with DROMA drug-omics association analysis databases using natural language.
A bridge to the Drug Gene Interaction Database (DGIdb) API, enabling AI clients to query drug-gene interaction data.
A search server for PubMed, the biomedical literature database, using a pure Node.js implementation.
Query the Materials Project database using the mp_api client. Requires an MP_API_KEY environment variable.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





