pythAIs - Pythagraph RED MCP Server

Node.js server implementing Model Context Protocol (MCP) for Pythagraph RED API access.

Features

• Fetch graph data from Pythagraph RED API

• Detailed graph analysis with nodes, edges, and statistics

• Formatted table outputs for easy visualization

• Comprehensive graph summaries

• Error handling and timeout management

API Integration

This server connects to the Pythagraph RED API at:

Tools

get_graph_data

Retrieve detailed graph data from Pythagraph RED API. Returns comprehensive information including nodes, edges, statistics, and metadata formatted as tables and descriptions.

Input:

• graphId (string): The unique identifier for the graph to retrieve

Output:

• Detailed tables showing graph statistics

• Node type distributions

• Edge type distributions

• First 10 nodes with their properties

• First 10 edges with their relationships

• Metadata information

Example:

get_graph_summary

Get a concise summary of graph data from Pythagraph RED API. Provides overview statistics, node/edge type distributions, and key insights.

Input:

• graphId (string): The unique identifier for the graph to get summary

• includeDetails (boolean, optional): Include detailed node and edge information (default: false)

Output:

• Quick overview with node and edge counts

• Node and edge type listings

• Graph density calculation

• Optional detailed tables when includeDetails is true

Example:

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

NPX

Docker

Development

Building

Testing

Docker Build

API Response Format

The server expects the Pythagraph RED API to return JSON data in this format:

Error Handling

The server includes comprehensive error handling for:

• Invalid graph IDs

• Network timeouts (30 second limit)

• API response errors

• Invalid JSON responses

• Connection failures

Features

• Automatic Table Formatting: Converts graph data into readable tables

• Statistics Calculation: Computes graph density and type distributions

• Memory Efficient: Only displays first 10 nodes/edges in detailed view

• Flexible Output: Summary mode for quick insights, detailed mode for analysis

• Robust Error Handling: Graceful handling of API failures

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.