Bio Agents
    Bio Agents

    Bio Agents

    MCP servers for Protein Data Bank, ChemBL, and other life science data (WIP), with Ollama client for local testing.

    4.3

    GitHub Stats

    Stars

    3

    Forks

    3

    Release Date

    5/18/2025

    about a month ago

    Detailed Description

    Bio-Agents MCP

    A collection of microservices and clients for natural language interaction with biological databases.

    Components

    • LLM Client: Natural language interface with web UI and terminal modes
    • PDB MCP Server: Protein Data Bank API service
    • ChEMBL MCP Server: Chemical database API service

    Architecture

    ┌─────────────┐     ┌──────────────┐
    │   LLM UI    │     │  Ollama LLM  │
    │  (Chainlit) │     │              │
    └─────┬───────┘     └───────┬──────┘
          │                     │
    ┌─────┴─────────────────────┴──────┐
    │           LLM Client             │
    └─────┬─────────────────────┬──────┘
          │                     │
    ┌─────┴───────┐     ┌──────┴───────┐
    │  PDB MCP    │     │  ChEMBL MCP  │
    │   Server    │     │    Server    │
    └─────────────┘     └──────────────┘
    

    Quick Start

    1. Configure environment:
    cp .env.example .env
    
    1. Start services:
    make build
    make up
    
    1. Launch web interface:
    make run-chainlit
    

    Visit http://localhost:8000 to start querying biological data.

    Development

    • Use make help to see available commands
    • Each service has its own README with detailed documentation
    • Configuration files are in conf/ directory

    Description

    This project contains multiple modules that interact with various services and APIs using the FastMCP framework. Each module is designed to perform specific tasks and can be run independently or together using Docker Compose. The primary focus of this project is on bio agents, providing tools and services to interact with biological data sources such as the Protein Data Bank (PDB).

    Modules

    LLM Client

    The llm-client module provides a client that interacts with a Language Model (LLM) server to process queries and utilize available tools. It is built using the FastMCP framework and supports asynchronous operations with aiohttp.

    For more details, refer to the LLM Client README.

    Protein Data Bank

    The protein_data_bank_mcp module provides a server that interacts with the Protein Data Bank (PDB) API to fetch structural assembly descriptions, chemical components, drugbank annotations, branched entities, non-polymer entities, polymer entities, uniprot annotations, structures, pubmed annotations, pdb cluster data aggregation, aggregation group provenance, pdb cluster data aggregation method, and pairwise polymeric interface descriptions. It is built using the FastMCP framework and supports asynchronous operations with aiohttp.

    For more details, refer to the Protein Data Bank README.

    Docker

    Dockerfiles are provided for each module to build Docker images.

    • Build the Docker image:

      docker build -t <module-name> .
      
    • Run the Docker container:

      docker run --env-file .env <module-name>
      

    Docker Compose

    A docker-compose.yml file is provided to run all services together.

    • Start all services:

      docker-compose up -d
      
    • Stop all services:

      docker-compose down
      

    Makefile

    A Makefile is provided to simplify common tasks.

    • Available targets:
      • setup-env: Set up the initial environment.
      • build: Build all Docker images.
      • up: Start all services using docker-compose.
      • down: Stop all services using docker-compose.
      • restart: Restart all services using docker-compose.

    About the Project

    This app has not been claimed by its owner yet.

    Claim Ownership

    Receive Updates

    Security Updates

    Get notified about trust rating changes

    to receive email notifications.