MCP Proto-OKN Server

A Model Context Protocol (MCP) server providing seamless access to SPARQL endpoints with specialized support for the NSF-funded Proto-OKN Project (Prototype Open Knowledge Network). This server enables querying the scientific knowledge graphs hosted on the FRINK platform. In addition, third-party SPARQL endpoints can be queried.

Natural Language Querying Across Knowledge Graphs with MCP

Video

Presentation

Features

• 🔗 FRINK Integration: Automatic detection and documentation linking for FRINK-hosted knowledge graphs
• 🕸️ Proto-OKN Knowledge Graphs: Optimized support for biomedical and scientific knowledge graphs, including:
  • 🧬 Biology & Health
  • 🌱 Environment
  • ⚖️ Justice
  • 🛠️ Technology & Manufacturing
• ⚙️ Flexible Configuration: Support for both FRINK and custom SPARQL endpoints
• 📚 Automatic Documentation: Registry links and metadata for Proto-OKN knowledge graphs
• 🌳 Ontology-driven Search Expansion: Queries are automatically expanded using ontology hierarchies
• 🔗 Federated Query: Prompts can query multiple endpoints

Architecture

The MCP Server Proto-OKN acts as a bridge between AI assistants (like Claude) and SPARQL knowledge graphs, enabling natural language queries to be converted into structured SPARQL queries and executed against scientific databases.

Prerequisites

Before installing the MCP Server Proto-OKN, ensure you have:

• Operating System: macOS, Linux, or Windows
• Client Application: One of the following:
  • Claude Desktop with Pro or Max subscription
  • VS Code Insiders with GitHub Copilot subscription

Installation

Installation instructions for Claude Desktop and VS Code Insiders

Quick Start

Once configured, you can start querying knowledge graphs through natural language prompts in Claude Desktop or VS Code chat interface.

Select and Configure MCP Tools (Claude Desktop)

From the top menu bar:

1. Select: Claude->Settings->Connectors
2. Click: Configure for the MCP endpoints you want to use
3. Select Tool permissions: Always allow

In the prompt dialog box, click the + button:

1. Turn off Web search
2. Toggle MCP services on/off as needed

Use @kg_name to refer to a specific knowledge graph in chat (for example, @spoke-genelab).

To create a transcript of a chat (see examples below), use the following prompt: Create a chat transcript. The transcript can then be downloaded in .md or .pdf format.

Example Queries

Knowledge Graph Overviews & Class Diagrams

Each link below points to a chat transcript that demonstrates how to generate a knowledge-graph overview and class diagram for a given Proto-OKN Theme 1 KG. The examples are grouped by domain area.

Use Cases

1. Spaceflight Missions (spoke-genelab)

2. Spaceflight Gene Expression Analysis (spoke-genelab, spoke-okn)

3. Spaceflight Gene Expression with Literature Analysis (spoke-genelab, spoke-okn, PubMed)

4. Spaceflight Gene Expression with Open Targets MCP integration (spoke-genelab, Open Targets, PubMed)

5. Disease Prevalence in the US (spoke-okn)

6. Disease Prevalence - Socio-Economic Factors Correlation (spoke-okn)

7. NIAID Data Exploration - COVID-19 Vaccine Research (nde)

8. Diabetic Nephropathy Meta-Analysis (gene-expression-atlas-okn)

9. Contamination at Superfund Sites (spoke-okn)

10. PFOA in Drinking Water (spoke-okn)

11. Data about PFOA (spoke-okn, biobricks-toxcast)

12. Biological Targets for PFOA (biobricks-toxcast)

13. Criminal Justice Patterns (scales)

14. Drug Possession Charges (scales)

15. Environmental Justice (sawgraph, scales, spatialkg, spoke-okn)

16. Rural Health Access (ruralkg, dreamkg, spoke-okn)

17. Michigan Flooding Event (ufokn)

18. Flooding and Socio-Economic Factors (ufokn, spatialkg, spoke-okn)

19. Philadelphia Area Incidents (nikg)

20. Mining Suppliers in North Dakota (sudokn)

Ontology-Driven Search Expansion

Queries are automatically expanded using ontology hierarchies (MONDO, HP, GO, UBERON, etc.) from the Ubergraph KG to include all descendant concepts, ensuring comprehensive retrieval without manual enumeration. For example, searching for "arthritic joint disease" automatically includes rheumatoid arthritis, osteoarthritis, ankylosing spondylitis, and all other subtypes.

1. Arthritic Joint Disease Datasets (nde)

2. Space Flight Studies Investigating Muscles (spoke-genelab)

Proto-OKN Integration Opportunities

1. Cross-KG Geolocation Data Exploration

2. Cross-KG Chemical Compound Data Exploration

Cross-Platform LLM Benchmarks

This section compares the results of two queries using Claude Desktop and VS Code Insiders with commons LLMs.

Benchmarks (in progress)

mcp-proto-okn vs. SPARQL Ground-Truth Evaluation

Benchmarks

Building and Publishing (maintainers only)

Instructions for building, testing, and publishing the mcp-proto-okn package on PyPI

API Reference and Query Analysis System

mcp-proto-okn server API

Troubleshooting

MCP server not appearing in Claude Desktop:

• Ensure you've completely quit and restarted Claude Desktop (not just closed the window)
• Check that your JSON configuration is valid (attach your config file to a chat and ask it to fix any errors)
• Verify that uvx is installed and accessible in your PATH (which uvx)

Connection errors:

• Verify the SPARQL endpoint URL is correct and accessible
• Some endpoints may have rate limits or temporary downtime

Performance issues:

• Complex SPARQL queries may take time to execute
• Consider breaking down complex queries into smaller parts

License

This project is licensed under the BSD 3-Clause License. See the LICENSE file for details.

Citation

If you use MCP Server Proto-OKN in your research, please cite the following works:

@software{rose2025mcp-proto-okn,
  title={MCP Server Proto-OKN},
  author={Rose, P.W. and Nelson, C.A. and Saravia-Butler, A.M. and Shi, Y. and Baranzini, S.E.},
  year={2025},
  url={https://github.com/sbl-sdsc/mcp-proto-okn}
}

@software{rose2025spoke-genelab,
  title={NASA SPOKE-GeneLab Knowledge Graph},
  author={Rose, P.W. and Nelson, C.A. and Gebre, S.G. and Saravia-Butler, A.M. and Soman, K. and Grigorev, K.A. and Sanders, L.M. and Costes, S.V. and Baranzini, S.E.},
  year={2025},
  url={https://github.com/BaranziniLab/spoke_genelab}
}

Related Publications

• Nelson, C.A., Rose, P.W., Soman, K., Sanders, L.M., Gebre, S.G., Costes, S.V., Baranzini, S.E. (2025). "Nasa Genelab-Knowledge Graph Fabric Enables Deep Biomedical Analysis of Multi-Omics Datasets." NASA Technical Reports, 20250000723. Link

• Sanders, L., Costes, S., Soman, K., Rose, P., Nelson, C., Sawyer, A., Gebre, S., Baranzini, S. (2024). "Biomedical Knowledge Graph Capability for Space Biology Knowledge Gain." 45th COSPAR Scientific Assembly, July 13-21, 2024. Link

Acknowledgments

Funding

This work is in part supported by:

• National Science Foundation Award #2333819: "Proto-OKN Theme 1: Connecting Biomedical information on Earth and in Space via the SPOKE knowledge graph"

Related Projects

• Proto-OKN Project - Prototype Open Knowledge Network initiative
• FRINK Platform - Knowledge graph hosting infrastructure
• Knowledge Graph Registry - Catalog of available knowledge graphs
• Model Context Protocol - AI assistant integration standard
• Original MCP Server SPARQL - Base implementation reference

For questions, issues, or contributions, please visit our GitHub repository.