MCPKG - Model Context Protocol Knowledge Graph

MCPKG is a Go implementation of a knowledge graph system that is exposed through the Model Context Protocol (MCP). It provides a simple yet powerful way to store, manage, and query semantic information in the form of subject-predicate-object triples.

Features

- Directed graph implementation for storing structured information
- Support for creating and querying semantic triples
- Persistent storage through serialization
- MCP server interface for programmatic access
- Custom URI format for graph queries
- Thread-safe implementation for concurrent use

Components

Knowledge Graph (KG)

The core data structure that:
- Stores entities as nodes
- Represents relationships as predicates (edges)
- Provides methods for inserting and querying triples
- Supports serialization and deserialization
- Ensures concurrent safety with a read-write mutex

MCP Server

An interface layer that:
- Exposes the knowledge graph as an MCP server
- Provides tools for inserting triples
- Supports graph queries via URI format
- Implements a stateless design for reliability

Usage

Inserting Information

Use the insert_triple tool with subject, predicate, and object parameters to add information to the graph.

Querying Information

Use the graph:// URI format to find relationships between entities.

Dependencies

- Go 1.24+
- github.com/mark3labs/mcp-go
- gonum.org/v1/gonum
- github.com/stretchr/testify (for testing)

License

MIT