mcpkg

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