swarmv-mcp

MCP server for SwarmV: gives an AI agent persistent vector memory, limited to what the signed-in user is allowed to see and edit.

Tools:

• read_from_memory returns the closest records (id, distance, metadata) from the containers the user can view.
• write_to_memory stores a note in a container the user can edit (put the text in metadata.text).

Setup

pip install swarmv-mcp

Add it to your MCP client's configuration (Claude Desktop, Cursor and others):

{
  "mcpServers": {
    "swarmv": {
      "command": "swarmv-mcp",
      "env": {
        "SWARMV_TOKEN_URL": "https://your-backend.example.com/swarmv-token",
        "SWARMV_TOKEN_URL_AUTH": "<the signed-in user's session credential>"
      }
    }
  }
}

Or without installing first: "command": "uvx", "args": ["swarmv-mcp"].

Credentials

Pick one:

Optional: SWARMV_DIM (vector dimensions, default 768), SWARMV_BASE_URL.

Full documentation: https://swarmv.dev/docs

License

MIT