siemens-graph-studio-mcp-server 0.1.0

MCP (Model Context Protocol) server for Siemens Graph Studio - enables AI agents to interact with knowledge graphs via SPARQL

Siemens Graph Studio MCP Server

An MCP (Model Context Protocol) server that enables AI agents to interact with Siemens Graph Studio knowledge graphs via SPARQL queries.

Features

• 🔍 Execute SPARQL Queries - Run queries against GraphMarts
• 📊 Discover Knowledge - Explore ontologies, classes, and properties
• 🔄 Manage GraphMarts - Create and modify transformation layers
• 🧠 AI-Powered Queries - Natural language to SPARQL translation (with OpenAI)
• 📦 Ontology Caching - Efficient schema discovery and caching

Installation

pip install siemens-graph-studio-mcp-server

Quick Start

1. Configure Environment Variables

export ANZO_SERVER="graph-studio.example.com"
export ANZO_PORT="8443"
export ANZO_USERNAME="your-username"
export ANZO_PASSWORD="your-password"
export GRAPHMART_URI="http://example.com/Graphmart/your-graphmart-id"

# Optional: For natural language queries
export API_KEY="sk-your-openai-api-key"

2. Run the Server

siemens-graph-studio-mcp

3. Use with Claude Desktop

Add to your ~/.config/claude-desktop/claude_desktop_config.json:

{
  "mcpServers": {
    "graph-studio": {
      "command": "siemens-graph-studio-mcp",
      "env": {
        "ANZO_SERVER": "graph-studio.example.com",
        "ANZO_PORT": "8443",
        "ANZO_USERNAME": "your-username",
        "ANZO_PASSWORD": "your-password",
        "GRAPHMART_URI": "http://example.com/Graphmart/your-graphmart-id",
        "API_KEY": "sk-your-openai-api-key"
      }
    }
  }
}

Configuration

Environment Variables

Variable	Required	Description
ANZO_SERVER	Yes	Graph Studio server hostname
ANZO_PORT	Yes	Server port (typically 8443)
ANZO_USERNAME	Yes	Authentication username
ANZO_PASSWORD	Yes	Authentication password
GRAPHMART_URI	Yes	Target GraphMart URI
API_KEY	No	OpenAI API key for NL queries
ENABLE_AGENT_DEBUG	No	Enable debug output
ENABLE_LOGGING_DEBUG	No	Enable detailed logging

Config File

Alternatively, use a config file:

siemens-graph-studio-mcp --config my-config.json

See examples/config.example.jsonc for a template.

Available Tools

System & Monitoring

• test_system_connection - Test MCP server and Graph Studio agent status
• get_session_logs - Get session logs and interaction history

SPARQL Query Execution

• execute_sparql_query - Execute SPARQL directly against GraphMart
• query_ags_configuration - Query Graph Studio configuration
• update_ags_configuration - Update Graph Studio configuration

Knowledge Discovery

• discover_knowledge_overview - Get overview of available knowledge
• discover_available_ontologies - List all available ontologies
• discover_ontology_classes - List classes in a specific ontology
• discover_class_data_properties - List data properties for a class
• discover_class_object_properties - List object properties for a class

Ontology Management

• create_ontology - Create new ontologies
• delete_ontology - Delete ontologies
• load_ontology_from_file - Load TTL files into named graphs
• register_ontology - Register ontologies
• add_ontology_class / remove_ontology_class - Manage classes
• add_ontology_property / remove_ontology_property - Manage properties
• get_ontology_cache_status / clear_ontology_cache / refresh_ontology_cache - Cache management

GraphMart Construction

• create_transformation_layer - Create transformation layers
• add_transformation_step - Add transformation steps
• add_direct_load_step - Add direct data loading steps
• update_transformation_layer / delete_transformation_layer - Layer management
• list_transformation_layers / list_transformation_steps - List components
• refresh_graphmart / reload_graphmart - GraphMart operations

Transport Modes

stdio (default)

For use with Claude Desktop and other MCP clients:

siemens-graph-studio-mcp

SSE (Server-Sent Events)

For web clients:

siemens-graph-studio-mcp --transport sse --port 8000

HTTP Streaming

siemens-graph-studio-mcp --transport streamable-http --port 8000

Programmatic Usage

import asyncio
from siemens_graph_studio_mcp import GraphmartConfig, SPARQLAgent

async def main():
    config = GraphmartConfig(
        ags_server="graph-studio.example.com",
        ags_port=8443,
        graphmart_uri="http://example.com/Graphmart/demo",
        username="admin",
        password="secret"
    )
    
    agent = SPARQLAgent(config)
    await agent.initialize()
    
    # Now use the agent...

asyncio.run(main())

Development

Setup

git clone https://github.com/siemens/graph-studio-mcp-server.git
cd graph-studio-mcp-server
pip install -e ".[dev]"

Running Tests

pytest

Building for Distribution

pip install build twine
python -m build

Publishing to PyPI

# Test PyPI
twine upload --repository testpypi dist/*

# Production PyPI
twine upload dist/*

Requirements

• Python 3.10+
• Access to a Siemens Graph Studio instance
• Valid user credentials with GraphMart access

License

Apache License 2.0 - See LICENSE for details.

Related

• Model Context Protocol - The MCP specification
• Siemens Graph Studio - Knowledge graph platform
• FastMCP - Python MCP framework

Support

For issues and feature requests, please use the GitHub Issues page.