55Your memory is managed by the ` mcp-knowledge-graph ` server, which provides these tools:
66
77## Contents
8+
89- [ Reading Tools] ( #reading-tools )
910- [ Writing Tools] ( #writing-tools )
1011- [ Maintenance Tools] ( #maintenance-tools )
@@ -20,6 +21,7 @@ Your memory is managed by the `mcp-knowledge-graph` server, which provides these
2021| ` read_graph ` | View entire memory graph | ` 9f1_read_graph() ` |
2122
2223** When to use each tool:**
24+
2325- ** search_nodes** : Use first for any information lookup (searches entity content)
2426- ** open_nodes** : Use when you know exact entity names
2527- ** read_graph** : Use only when other methods fail or you need full context
@@ -33,11 +35,13 @@ Your memory is managed by the `mcp-knowledge-graph` server, which provides these
3335| ` create_relations ` | Link related entities | ` 9f1_create_relations(relations: [{"from": "AppDataStorage", "relationType": "implements", "to": "JSON Serialization"}]) ` |
3436
3537** When to use each tool:**
38+
3639- ** add_observations** : Always try this first before creating new entities
3740- ** create_entities** : Create new entities only when they don't already exist
3841- ** create_relations** : Create meaningful connections between entities
3942
4043** Important Note About create_entities** :
44+
4145- The ` create_entities ` tool returns a list of successfully created entities
4246- If an entity you intended to create is not included in the response, it means that entity already exists in memory
4347- Existing entities are not updated by ` create_entities ` - use ` add_observations ` for those instead
@@ -61,6 +65,7 @@ cd .github/copilot
6165```
6266
6367This script automatically:
68+
6469- Creates timestamped backups before changes
6570- Sorts entities by logical type groups
6671- Arranges properties in consistent order
@@ -71,28 +76,33 @@ This script automatically:
7176### Information Lookup Workflow
7277
73781 . ** Start with targeted search** :
79+
7480 ``` text
7581 9f1_search_nodes(query: "AppDataStorage")
7682 ```
7783
78842 . ** If targeted search doesn't find what you need** , try viewing specific entities:
85+
7986 ``` text
8087 9f1_open_nodes(names: ["AppDataStorage", "ImGuiWidgets"])
8188 ```
8289
83903 . ** Only as a last resort** , view the entire graph:
91+
8492 ``` text
8593 9f1_read_graph()
8694 ```
8795
8896### Information Creation Workflow
8997
90981 . ** First check if entity exists** :
99+
91100 ``` text
92101 9f1_search_nodes(query: "EntityName")
93102 ```
94103
951042 . ** Try adding observations first** (will fail if entity doesn't exist):
105+
96106 ``` text
97107 9f1_add_observations(observations: [{
98108 "entityName": "AppDataStorage",
@@ -101,6 +111,7 @@ This script automatically:
101111 ```
102112
1031133 . ** If add_observations fails, create the entity** :
114+
104115 ``` text
105116 9f1_create_entities(entities: [{
106117 "name": "AppDataStorage",
@@ -114,6 +125,7 @@ This script automatically:
114125 - If your entity is missing from the returned list → Entity already existed (use add_observations instead)
115126
1161275 . ** Create relationships to connect entities** :
128+
117129 ``` text
118130 9f1_create_relations(relations: [{
119131 "from": "AppDataStorage",
0 commit comments