mcpField
A
anairyspirit

anairyspirit

Local
github.comMemory & Knowledge2Updated 1d ago
RepositoryVisit website

About anairyspirit

anairyspirit is a personal memory graph installed and run on the user's machine for AI agents that need long-term memory. It provides access over MCP and REST, keeping data local.

Key features

  1. 01Local personal memory graph
  2. 02Long-term agent memory
  3. 03MCP and REST access
  4. 04Setup and update commands

Use cases

  1. 01Keep agent memories on a local machine
  2. 02Give agents long-term memory over MCP

MCP support

AI clients can launch the installed program with its `mcp` command to access memory. The project also provides REST access.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "seventhwalllab-anairyspirit": {
      "command": "npx",
      "args": [
        "-y",
        "anairyspirit"
      ]
    }
  }
}
Run commandnpx -y anairyspirit

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmanairyspirit0.1.440

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

anairyspirit

A personal AI memory graph that runs on your own machine. Your AI agents keep long-term memory in it over MCP and REST; nothing leaves the machine.

This package installs it and runs it — macOS and Linux (x86_64, arm64), Node 18 or newer. It carries no program itself: it downloads the release it was built for from GitHub and checks it against the checksums of that release's signed manifest before anything runs.

Install

npx anairyspirit setup

setup asks about encryption and the rest, installs the program as anairyspirit (in /usr/local/bin, or ~/.local/bin — then open a new terminal) and starts its service.

Use it from an AI client

Once installed, every command goes to the installed program, so an MCP client can start it like this:

{ "command": "npx", "args": ["-y", "anairyspirit", "mcp"] }

Update

npx anairyspirit@latest update

installs the newest release over yours — your memory, settings and keys stay. An install made by Homebrew or a package is updated the way it came; the program says how.

Installed with npm i -g

The command is then anairyspirit-npm (the program itself is anairyspirit, and the two must not share a name): anairyspirit-npm setup, anairyspirit-npm update.

Other ways to install — a macOS disk image, Homebrew, Debian/Ubuntu and Fedora/openSUSE packages, Docker — and the manual: https://github.com/Seventhwalllab/anairyspirit

The program and this package are distributed under the An Airy Spirit End-User Licence Agreement: LICENSE and EULA.txt in this package, shown again by setup.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.