
How to add gget-mcp to Windsurf
Bioinformatics MCP server wrapping the gget toolkit for gene, sequence, structure, and enrichment queries. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.
Last updated June 14, 2026 · 29★ · stdio · no auth
Windsurf config for gget-mcp
uvx --from gget-mcp@latest stdio{
"mcpServers": {
"gget-mcp": {
"command": "uvx",
"args": [
"--from",
"gget-mcp@latest",
"stdio"
]
}
}
}Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.
Setup steps
- 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
- 2Paste the gget-mcp config below.
- 3Fill in placeholder secrets, then save.
- 4Click Refresh in the MCP panel.
- 5gget-mcp's tools become available to Cascade.
Before you start
- uv / uvx (or Python 3.10+) to run the server
- Stable internet connection (gget tools query external genomic databases and web services)
- An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
What gget-mcp can do in Windsurf
gget_searchFind Ensembl IDs associated with search terms.
gget_infoFetch detailed information for Ensembl IDs.
gget_seqRetrieve nucleotide or amino acid sequences (supports translate=True for protein).
gget_refGet reference genome information from Ensembl.
gget_blastBLAST nucleotide or amino acid sequences to identify their origin.
gget_blatFind the genomic locations of sequences.
gget_muscleAlign multiple sequences (MUSCLE) and identify conserved regions.
gget_archs4Get gene expression data from ARCHS4 across tissues.
Security
No API key is required for the core server, but many gget tools query external web services and databases that may be rate-limited or temporarily unavailable. The optional LLM-based 'judge' tests require API keys (e.g. GEMINI_API_KEY) and may incur costs, but these are for development only and are not needed to run the server.
gget-mcp + Windsurf FAQ
Where is the Windsurf config file?
Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the gget-mcp config there under the "mcpServers" key and restart the client.
Is gget-mcp safe to use with Windsurf?
No API key is required for the core server, but many gget tools query external web services and databases that may be rate-limited or temporarily unavailable. The optional LLM-based 'judge' tests require API keys (e.g. GEMINI_API_KEY) and may incur costs, but these are for development only and are not needed to run the server.
Do I need an API key?
No. The core server requires no API key. Many tools query external public databases, so an internet connection is needed. Only the optional development 'judge' tests require LLM API keys.
Which transport modes are supported?
STDIO (recommended for MCP clients and for saving large outputs to disk), HTTP (default port 3002, endpoint /mcp, docs at /docs), and SSE.
Is this an official gget tool?
No. gget-mcp is built by the Longevity Genie project and wraps the gget library from pachterlab; it is a community/third-party MCP wrapper.