Memory Knowledge Graph

A knowledge graph memory server implemented in Swift, providing persistent memory functions for large - language models

Knowledge management and memory Artificial intelligence chatbots #Knowledge Graph #Memory Storage #AI Tool .swift

rating : 3 points

downloads : 129

update time : 2025-04-28

What is the Memory MCP Server?

The Memory MCP Server is a knowledge graph management tool for creating, reading, updating, and deleting entities and their relationships. It allows AI assistants to maintain long - term memories across different sessions.

How to use the Memory MCP Server?

Through simple command - line operations, you can easily add, query, and delete entities and relationships. You can start using it in just a few steps.

Applicable Scenarios

Suitable for application scenarios that require cross - session storage and retrieval of information, such as customer service systems, personal assistants, and knowledge management systems.

Main Features

Knowledge Graph StoragePersistently store entities and their relationships to form a complete knowledge network.

Entity ManagementSupport creating, reading, updating, and deleting entities, and assign custom types to them.

Relationship TrackingDefine and manage relationships between entities to ensure clear semantics and easy understanding.

Observation SystemDynamically record changes and newly discovered information about entities.

Powerful Search FunctionQuickly locate relevant information based on name, type, or observation content.

Data PersistenceData is stored in JSON format and supports cross - session retention.

Advantages and Limitations

Advantages

Support cross - session memory to enhance the service capabilities of AI assistants.

Flexible data structure adapts to various application scenarios.

Simple and easy - to - use command - line interface reduces the learning cost.

Limitations

Currently, it only supports macOS 14.0 and above.

For broader platform support, it is recommended to use the Go language version.

How to Use

Install the Server

Quickly install via a curl script, or compile from source code and install manually.

Start the Server

Run the server and specify the configuration file path (optional).

Execute Commands

Use the provided API commands to manage the knowledge graph.

Usage Examples

Create EntitiesAdd new entities to the knowledge graph.

Search NodesFind nodes that meet the conditions.

Frequently Asked Questions

How to change the default storage path?

Does it support other operating systems?

How to check the server version?

Related Resources

Official Documentation

Detailed server usage manual.

GitHub Repository

Source code and project homepage.

Go Language Version

Support for a wider range of platforms.

🚀 Memory MCP Server

A knowledge graph memory server implemented in Swift for the Model Context Protocol (MCP), providing persistent memory functionality for large language models. This project is based on the official TypeScript implementation but rewritten in Swift using the MCP Swift SDK.

✨ Features

Fast Response: Efficiently handle memory operation requests.
Persistent Storage: Persist data to the local file system.
Clear Structure: Adopt a simple and clear knowledge graph structure.
Easy to Extend: Support future feature expansion and optimization.
Good Compatibility: Seamlessly integrate with the MCP protocol.

📦 Installation

System Requirements

Swift 6.0 or higher
macOS 14.0 or higher
MCP Swift SDK 0.2.0 or higher

Installation Steps

Clone the project repository:

git clone https://github.com/okooo5km/memory-mcp-server.git
cd memory-mcp-server

Run the installation script (optional):
```
./install.sh
```
Start the server:
```
swift run -- --port 8080
```

💻 Usage Examples

Create Entities

{
  "entities": [
    {
      "name": "John Smith",
      "entityType": "Person",
      "observations": ["Software engineer", "Lives in San Francisco", "Likes hiking"]
    },
    {
      "name": "Acme Corp",
      "entityType": "Company",
      "observations": ["Founded in 2010", "Tech startup"]
    }
  ]
}

Create Relations

{
  "relations": [
    {
      "from": "John Smith",
      "to": "Acme Corp",
      "relationType": "Works at"
    }
  ]
}

Add Observations

{
  "observations": [
    {
      "entityName": "John Smith",
      "contents": ["Recently promoted to senior engineer", "Working on an AI project"]
    }
  ]
}

Search Nodes

{
  "query": "San Francisco"
}

Open Specific Nodes

{
  "names": ["John Smith", "Acme Corp"]
}

📚 Documentation

Use Cases

Long-term Memory for AI Assistants: Enable AI assistants to remember user preferences, past interactions, and important facts.
Knowledge Management: Organize information about people, places, events, and concepts.
Relationship Tracking: Maintain a network of relationships between entities.
Context Persistence: Save important context across multiple sessions.
Diary and Daily Records: Keep structured records for easy retrieval and association of past experiences in chronological order.

Version History

Check the GitHub Releases page for version history and change logs.

☕️ Support the Project

If you find Memory MCP Server helpful, please consider supporting its development:

⭐️ Star the project on GitHub
🐛 Report bugs or suggest features
💝 Support methods:

📄 License

memory-mcp-server is licensed under the MIT License. This means you can freely use, modify, and distribute the software, but you must comply with the terms and conditions of the MIT License.