miEAA3 MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@miEAA3 MCP Server run enrichment analysis for hsa-miR-21-5p and hsa-miR-155-5p"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
miEAA3_MCP
An MCP (Model Context Protocol) server that integrates the miEAA 3.x REST API with Claude Desktop, exposing miEAA functionality as callable tools for microRNA and precursor enrichment analysis.
Introduction
miEAA3_MCP provides a clean integration layer between Claude Desktop and the miEAA bioinformatics platform.
The server is implemented in TypeScript, bundled as a single Node.js ESM entry point, and registered with Claude via MCP.
The project focuses on:
Correct MCP protocol integration
Robust request/response normalization
Reliable execution of miEAA tools inside Claude Desktop
No biological logic is reimplemented; all analysis is performed by the official miEAA API.
Related MCP server: BioOpenMCP
Repository Structure
miEAA3_mcp/
├── README.md
├── manifest.json
├── package.json
├── package-lock.json
├── tsconfig.json
├── dist/
│ ├── server.js
│ └── handlers/
│ ├── mieaa_categories_handler.js
│ ├── mieaa_mirna_precursor_converter_handler.js
│ ├── mieaa_mirbase_converter_handler.js
│ └── over_representation_analysis_handler.js
├── src/
│ ├── server.ts
│ ├── handlers/
│ │ ├── mieaa_categories_handler.ts
│ │ ├── mieaa_mirna_precursor_converter_handler.ts
│ │ ├── mieaa_mirbase_converter_handler.ts
│ │ └── over_representation_analysis_handler.ts
│ └── utils/
│ └── mieaa.ts
├── test.mjs
└── miEAA3_mcp.dxtIntegrated Tools (Claude MCP)
The following four miEAA tools are integrated, registered, and visible in Claude Desktop:
1. Over-Representation Analysis (ORA)
Tool: over_representation_analysis
Runs miEAA ORA for miRNA or precursor inputs
Handles job submission, polling, and result retrieval
Supports category-based enrichment analysis
2. List Enrichment Categories
Tool: list_enrichment_categories
Queries available enrichment categories from miEAA
Intended to guide category selection for ORA
3. miRNA ↔ Precursor Converter
Tool: mirna_precursor_converter
Converts between miRNA and precursor identifiers
Handles miEAA rate limits
Normalizes plain-text API responses into structured output
4. miRBase Version Converter
Tool: mirbase_version_converter
Converts miRNA identifiers between miRBase versions
Explicitly reports converted, unchanged, and unmappable entries
Environment Setup
Prerequisites
Node.js ≥ 18
npm
Install dependencies:
npm installBuild Process
The MCP server must be bundled into a single ESM-compatible file for Claude Desktop.
npx esbuild src/server.ts --bundle --platform=node --format=esm --target=node18 --outfile=dist/server.js --log-level=debugWhy this build step is required
Bundles all handlers and utilities into one file
Ensures compatibility with Claude’s Node runtime
Resolves MCP SDK and module resolution issues
Claude Desktop Integration
The MCP server is correctly discovered and launched by Claude Desktop
Extension folder detection issues are resolved
MCP SDK resolution issues are resolved by the current build setup
All four tools appear as callable tools inside Claude
No manual server startup is required when using Claude Desktop.
Local Testing
node test.mjsAll tools execute correctly in a local Node.js environment.
MCP Inspector
For protocol-level inspection and debugging:
npm install @modelcontextprotocol/inspector --save-dev
npx @modelcontextprotocol/inspectorUsing in Claude as .dxt
Install prerequisites: Node.js ≥ 18, npm, and Claude Desktop
Clone or open the
miEAA3_mcpproject directoryInstall dependencies:
npm install
Build the MCP server into a single ESM file:
npx esbuild src/server.ts \
--bundle \
--platform=node \
--format=esm \
--target=node18 \
--outfile=dist/server.jsnpx esbuild src/server.ts `
--bundle `
--platform=node `
--format=esm `
--target=node18 `
--outfile=dist/server.jsCreate the Claude extension package (.dxt)
(or use the existing .dxt file from the repository):
zip -r miEAA3_mcp.dxt \
manifest.json \
package.json \
package-lock.json \
tsconfig.json \
dist \
-x "*.ts" "*.map" "*.log"Open Claude Desktop → Settings → Advanced → Install Extension
Select the miEAA3_mcp.dxt file (from your Windows or local folder)
Open a new Claude chat and use the miEAA tools directly
(no manual server start required)
Current Issue
At the moment, I am refining the result formatting, so the outputs are more structured and easier to use by user, while remaining MCP-compatible. The miEAA server was temporarily down during testing, but I expect to complete this today once it is reachable again.
One issue I encountered is that GSEA analysis has API endpoints but expects a different input format that is not documented on the miEAA website, which currently prevents successful execution. All other API-based tools are working as expected.
Available Tools
4 toolslist_enrichment_categoriesC
List available miEAA enrichment categories for a species.
Inputs: species (required), entity (required).
mirbase_version_converterB
Convert miRNA identifiers between miRBase versions.
Inputs: mirnas (required), source_version (required), target_version (required).
mirna_precursor_converterC
Convert between miRNA names and precursor names.
Inputs: input (required), direction (required).
over_representation_analysisC
Run miEAA over-representation analysis (ORA) for miRNA or precursor.
Inputs: species (required), entity (required), ids (required), category_selection, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: listing categories, converting miRNA identifiers, converting miRNA/precursor names, and running over-representation analysis. There is no overlap or ambiguity between these functions, making tool selection straightforward for an agent.
Three tools follow a consistent verb_noun pattern (list_enrichment_categories, mirna_precursor_converter, over_representation_analysis), while one uses a noun_verb_noun pattern (mirbase_version_converter). This minor deviation slightly reduces consistency but the naming remains readable and predictable overall.
With 4 tools, the server is well-scoped for miRNA enrichment analysis, covering key operations like listing categories, identifier conversion, and analysis. Each tool earns its place without feeling excessive or insufficient for the domain.
The toolset covers essential workflows for miEAA, including data preparation (conversions) and analysis (ORA). A minor gap exists in lacking tools for other analysis types (e.g., gene set enrichment), but agents can still perform core tasks effectively with the provided tools.
Maintenance
Related MCP Connectors
Your WhatsApp history in Claude and ChatGPT: search years of chats, voice notes transcribed.
Add any agent you deploy on ibl.ai to Claude Code, Cursor or Claude Desktop and talk to it there.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables querying the Drug Gene Interaction Database (DGIdb) through natural language, allowing users to search for drug-gene interactions, gene information, and drug attributes directly from Claude Desktop.Apache 2.0
- FlicenseNot gradedqualityDmaintenanceBioOpenMCP enables users to run bioinformatics tools like FastQC, Cutadapt, and STAR with background execution and status checking. It integrates with Claude Desktop to perform quality control, trimming, alignment, and reporting via natural language.1-
- AlicenseAqualityDmaintenanceEnables bioinformatics analysis through natural language conversations with Claude Desktop, automatically generating and executing Python scripts to produce HTML reports and visualizations.39MIT
- AlicenseAqualityCmaintenanceConnects PyMOL to Claude AI for conversational structural biology, molecular visualization, and analysis through natural language.3MIT