Knowledge Graph

by itseasy21

34 stars

5.4k downloads

Not rated

GitHub

About

Provides persistent memory for Claude through a local knowledge graph that stores entities with observations and relations, enabling structured information retrieval and complex context retention across conversations.

Details

Author: itseasy21
Repository: itseasy21/mcp-knowledge-graph
GitHub stars: 34
Downloads: 5,432
License: MIT License
Categories: Community, AI, Developer Tools, Search, Infrastructure, Communication, API
Tags: #visualization

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Knowledge Graph

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @itseasy21/mcp-knowledge-graph
Environment
- MEMORY_FILE_PATH /path/to/your/projects.jsonl
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

`create_entities`

Create multiple new entities in the knowledge graph. Input: entities (array of objects) where each object contains name (string), entityType (string), and observations (string[]). Ignores entities with existing names.

`create_relations`

Create multiple new relations between entities. Input: relations (array of objects) where each object contains from (string), to (string), and relationType (string). Skips duplicate relations.

`add_observations`

Add new observations to existing entities. Input: observations (array of objects) where each object contains entityName (string) and contents (string[]). Returns added observations per entity and fails if entity doesn't exist.

`delete_entities`

Remove entities and their relations. Input: entityNames (string[]). Cascading deletion of associated relations; silent operation if entity doesn't exist.

`delete_observations`

Remove specific observations from entities. Input: deletions (array of objects) where each object contains entityName (string) and observations (string[]). Silent operation if observation doesn't exist.

`delete_relations`

Remove specific relations from the graph. Input: relations (array of objects) where each object contains from (string), to (string), and relationType (string). Silent operation if relation doesn't exist.

`read_graph`

Read the entire knowledge graph. No input required. Returns complete graph structure with all entities and relations.

`search_nodes`

Search for nodes based on query. Input: query (string). Searches across entity names, entity types, and observation content. Returns matching entities and their relations.

`open_nodes`

Retrieve specific nodes by name. Input: names (string[]). Returns requested entities and relations between requested entities; silently skips non-existent nodes.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "knowledge graph": {
            "env": {
                "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
            },
            "args": [
                "-y",
                "@itseasy21/mcp-knowledge-graph"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
    },
    "args": [
        "-y",
        "@itseasy21/mcp-knowledge-graph"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
    },
    "args": [
        "-y",
        "@itseasy21/mcp-knowledge-graph"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "MEMORY_FILE_PATH": "/path/to/your/projects.jsonl"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "@itseasy21/mcp-knowledge-graph"
    ],
    "command": "cmd"
}

Knowledge Graph Memory Server

An improved implementation of persistent memory using a local knowledge graph with a customizable memory path.

This lets Claude remember information about the user across chats.

> [!NOTE]
> This is a fork of the original Memory Server and is intended to not use the ephemeral memory npx installation method.

Server Name

mcp-knowledge-graph

screen-of-server-name

read-function

Core Concepts

Entities

Entities are the primary nodes in the knowledge graph. Each entity has:

- A unique name (identifier)
- An entity type (e.g., "person", "organization", "event")
- A list of observations
- Creation date and version tracking

The version tracking feature helps maintain a historical context of how knowledge evolves over time.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

create_entities

create_relations

add_observations

delete_entities

delete_observations

delete_relations

read_graph

search_nodes

open_nodes

Claude Desktop / Cursor

Linux

Macos

Windows

Knowledge Graph Memory Server

Server Name

Core Concepts

Entities

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`create_entities`

`create_relations`

`add_observations`

`delete_entities`

`delete_observations`

`delete_relations`

`read_graph`

`search_nodes`

`open_nodes`