open-coscientist
Open-source AI Co-Scientist based on Google Research — PubMed literature search, INDRA knowledge graph, hypothesis generation. From jataware/open-coscientist
SKILL.mdskills/research/open-coscientist/SKILL.md
GitHubOpen Coscientist
Overview
Open-source adaptation of Google Research's AI Co-Scientist paper, providing an MCP server with:
- PubMed search — search biomedical literature with full-text extraction
- INDRA CoGex knowledge graph — query gene-disease networks, drug info, clinical trials, pathways, enrichment analysis
- Hypothesis generation — multi-agent architecture that generates, reviews, ranks, and evolves research hypotheses
Setup
Prerequisites
- Docker and Docker Compose
- NCBI Entrez email (free, for PubMed API)
Installation
Clone the repo:
git clone https://github.com/jataware/open-coscientist.git cd open-coscientistConfigure environment:
cp mcp_server/.env.example mcp_server/.env # Edit mcp_server/.env: # ENTREZ_EMAIL=your_email@example.com # ENTREZ_API_KEY=your_key (optional but recommended)Start the MCP server:
docker compose up -dVerify it's running:
curl http://localhost:8888 # → {"status":"running","service":"coscientist-lit-review","version":"0.1.0","mcp_tools":[...]}
Hermes MCP Configuration
Add to your ~/.hermes/config.yaml:
mcp_servers:
coscientist:
url: "http://localhost:8888/mcp"
transport: streamable-http
timeout: 120
connect_timeout: 30
Why streamable-http: The coscientist server sets stateless_http = True and uses mcp.http_app() with streamable-http transport. Its MCP endpoint is at /mcp, not /sse. This is the correct transport for this server — do not change it to sse.
Available MCP Tools
Once configured, these tools become available to Hermes:
| Tool | Purpose |
|---|---|
check_pubmed_available |
Test PubMed service connectivity |
search_pubmed |
Search PubMed by query terms |
pubmed_search_with_fulltext |
Search PubMed + download full text from PMC |
query_gene_disease_network |
Query gene-disease associations |
query_gene_codependents |
Find genes that co-depend with a target gene |
query_drug_info |
Look up drug information |
query_clinical_trials |
Search clinical trials |
query_pathways |
Query biological pathways |
query_causal_subnetwork |
Query causal subnetwork |
query_mechanistic_statements |
Get mechanistic statements |
run_enrichment_analysis |
Run enrichment analysis |
When to Use
- Biomedical literature searches
- Drug discovery research
- Gene-disease network analysis
- Clinical trial investigation
- Hypothesis generation and testing
- Academic paper synthesis
- Scientific literature review
Pitfalls
- PubMed API requires an Entrez email — without it, requests may be rate-limited
- Docker container must be running for the MCP server to be available
- INDRA CoGex queries on large networks can be slow (timeout handled up to 60s)
- Paper cache stored at
./mcp_server/paper_cache/