Hystersis MCP Server

This is the standalone Model Context Protocol (MCP) server for Hystersis, the persistent memory engine for AI agents.

Overview

This server allows you to expose Hystersis' memory capabilities directly to MCP clients like Claude Desktop, Cursor, or any other MCP-compatible assistant. It serves as a bridge, wrapping the Hystersis Go REST API in the standard MCP protocol.

Setup

1. Install dependencies:

npm install

2. Build the server:

npm run build

3. Configure your MCP client (e.g., Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "hystersis": {
      "command": "node",
      "args": ["/path/to/hystersis-mcp/build/index.js"],
      "env": {
        "HYSTERSIS_API_URL": "http://localhost:8080",
        "HYSTERSIS_API_KEY": "your-secret-key"
      }
    }
  }
}

Available Tools

• add_memory: Add a new memory or fact to the memory graph.
• search_memories: Retrieve memories using semantic search, hybrid search, or spreading activation.
• create_entity: Explicitly create an entity in the Hystersis knowledge graph.
• create_relation: Define a relationship between two entities.

Publishing to NPM

To publish this package to NPM so others can use it via npx:

1. Update the name and version in package.json (e.g. @your-username/hystersis-mcp).
2. Login to npm: npm login
3. Publish: npm publish --access public

Then users can run:

npx @your-username/hystersis-mcp