Skip to main content
Glama

BioOntology MCP Server

MIT License
2

Logo

Unofficial BioOntology MCP Server

A production-ready Model Context Protocol (MCP) server that provides comprehensive access to the BioOntology API for searching, annotating, and exploring over 1,200 biological ontologies.

Features

Search & Discovery

  • search_terms - Search across ontology terms with advanced filtering options
  • search_properties - Search ontology properties by labels and IDs
  • search_ontologies - Find ontologies by name, description, or domain
  • get_ontology_info - Get detailed information about specific ontologies

Text Analysis

  • annotate_text - Analyze text and identify relevant ontology terms
  • recommend_ontologies - Get ontology recommendations for text or keywords
  • batch_annotate - Process multiple texts for annotation efficiently

Ontology Navigation

  • get_class_info - Get detailed information about ontology classes

Analytics & Metadata

  • get_ontology_metrics - Get usage statistics and quality metrics
  • get_analytics_data - Get visitor statistics and popularity trends

Installation

  1. Clone or download this server
  2. Install dependencies:
    npm install
  3. Build the server:
    npm run build

Configuration

You need a BioOntology API key to use this server. Get one from BioPortal:

  1. Create an account at https://bioportal.bioontology.org/
  2. Generate an API key from your account settings
  3. Set the environment variable:
    export BIOONTOLOGY_API_KEY=your_api_key_here

Usage

Running the Server

node build/index.js

The server runs on stdio and implements the MCP protocol for communication with MCP-compatible clients.

Resource Templates

The server provides several resource templates for direct data access:

  • bioontology://ontology/{acronym} - Complete ontology information
  • bioontology://class/{ontology}/{class_id} - Ontology class details
  • bioontology://search/{query} - Term search results
  • bioontology://annotations/{text} - Text annotation results
  • bioontology://recommendations/{input} - Ontology recommendations
  • bioontology://analytics/{ontology} - Analytics data

Example Tool Calls

Search for terms:

{ "tool": "search_terms", "arguments": { "query": "diabetes", "ontologies": "NCIT,DOID", "require_definitions": true, "pagesize": 10 } }

Annotate text:

{ "tool": "annotate_text", "arguments": { "text": "The patient has diabetes mellitus and hypertension", "ontologies": "NCIT,DOID,HP", "longest_only": true } }

Get ontology recommendations:

{ "tool": "recommend_ontologies", "arguments": { "input": "cancer treatment protocols", "input_type": 1, "output_type": 1 } }

Batch annotate multiple texts:

{ "tool": "batch_annotate", "arguments": { "texts": ["diabetes mellitus", "cardiac arrest", "lung cancer"], "ontologies": "NCIT", "longest_only": true } }

Supported Ontologies

The server works with all ontologies available in BioPortal (1,200+), including:

Medical/Clinical:

  • NCIT - NCI Thesaurus (cancer terminology)
  • DOID - Disease Ontology
  • HP - Human Phenotype Ontology
  • MESH - Medical Subject Headings

Biological/Chemical:

  • GO - Gene Ontology
  • UBERON - Anatomy ontology
  • CHEBI - Chemical entities of biological interest

And 1,190+ more specialized ontologies

Integration with MCP Clients

This server is compatible with any MCP-enabled client. Popular options include:

  • Claude Desktop - Add to your MCP configuration
  • VSCode Extensions - Use with MCP-compatible extensions
  • Custom Applications - Integrate via the MCP protocol

MCP Configuration Example

Add to your MCP client configuration:

{ "servers": { "bioontology": { "command": "node", "args": ["/path/to/bioontology-server/build/index.js"], "env": { "BIOONTOLOGY_API_KEY": "your_api_key_here" } } } }

Advanced Features

Input Validation

  • Comprehensive parameter validation with proper error messages
  • Type checking for all inputs
  • Range validation for numeric parameters
  • Enum validation for restricted values

Error Handling

  • Graceful handling of API errors
  • Structured error responses
  • Network timeout management
  • Authentication error reporting

Performance

  • Efficient API request handling
  • Proper timeout management
  • Memory usage optimization
  • Concurrent request support

API Documentation

For detailed BioOntology API documentation, see: https://data.bioontology.org/documentation

Production Use

This server has been thoroughly tested and is ready for production use. It provides:

  • Reliable API integration with robust error handling
  • Comprehensive input validation for all tools
  • Full MCP protocol compliance for seamless integration
  • Support for 1,200+ ontologies across all biological domains
  • High performance with optimized response times

License

MIT License - see LICENSE file for details.

Citation

If you use this project in your research or publications, please cite it as follows:

-
security - not tested
A
license - permissive license
-
quality - not tested

A production-ready Model Context Protocol (MCP) server that provides comprehensive access to the BioOntology API for searching, annotating, and exploring over 1,200 biological ontologies.

  1. Features
    1. Search & Discovery
    2. Text Analysis
    3. Ontology Navigation
    4. Analytics & Metadata
  2. Installation
    1. Configuration
      1. Usage
        1. Running the Server
        2. Resource Templates
        3. Example Tool Calls
      2. Supported Ontologies
        1. Integration with MCP Clients
          1. MCP Configuration Example
        2. Advanced Features
          1. Input Validation
          2. Error Handling
          3. Performance
        3. API Documentation
          1. Production Use
            1. License
              1. Citation

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol (MCP) server that provides search and crawl functionality using Search1API.
                  Last updated -
                  5
                  206
                  111
                  TypeScript
                  MIT License
                  • Apple
                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that interfaces with Biomart databases, allowing models to discover biological datasets, explore attributes/filters, retrieve biological data, and translate between different biological identifiers.
                  Last updated -
                  8
                  5
                  Python
                  MIT License
                  • Apple
                  • Linux
                • A
                  security
                  A
                  license
                  A
                  quality
                  An MCP server that allows searching for and retrieving information about Model Context Protocol servers registered on the MCP Hub.
                  Last updated -
                  1
                  MIT License
                  • Apple
                  • Linux
                • A
                  security
                  F
                  license
                  A
                  quality
                  An all-in-one Model Context Protocol (MCP) server that connects your coding AI to numerous databases, data warehouses, data pipelines, and cloud services, streamlining development workflow through seamless integrations.
                  Last updated -
                  2
                  Python
                  • Apple
                  • Linux

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/Augmented-Nature/BioOntology-MCP-Server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server