Skip to main content

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:

Variables Use
SWARMV_TOKEN_URL (+ optional SWARMV_TOKEN_URL_AUTH) Recommended. Your backend returns { "token": "..." }, a short-lived user token it minted with your API key.
SWARMV_USER_TOKEN A user token you already have (expires).
SWARMV_API_KEY + SWARMV_USER_ID=user:<id> Local development only. Never ship your API key to end users.

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

Full documentation: https://edgevec.pages.dev/docs

License

MIT

Metadata

Release files for swarmv-mcp 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for swarmv-mcp 1.2.0
File Size Uploaded
swarmv_mcp-1.2.0.tar.gz 4.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for swarmv-mcp 1.2.0
File Interpreter ABI Platform
swarmv_mcp-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.2 kB

Release files / swarmv_mcp-1.2.0.tar.gz

Download URL swarmv_mcp-1.2.0.tar.gz
Size 4.2 kB
Tags Source
SHA-256 checksum
How to use checksums
e424e07040945729fdcfaeb5c3611171ab9658ffca1805dbc4248f253bb7e0f0
BLAKE2b-256 checksum
How to use checksums
fe7754eba932d66f272ce971c4f4968ffd5c074683c6ad3f6ec502309bb183ce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.7

Release files / swarmv_mcp-1.2.0-py3-none-any.whl

Download URL swarmv_mcp-1.2.0-py3-none-any.whl
Size 5.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
db417d70fe2924d20b06f66fd8788808179143cbbd837ed20acf70365dea6376
BLAKE2b-256 checksum
How to use checksums
6433fd376e89810d99f36b34bac887d3207b5edf2c876eb0958e3a1191e044c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.7

Release history Release notifications | RSS feed

1.2.1

2 release files

This release

1.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page