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_memoryreturns the closest records (id, distance, metadata) from the containers the user can view.write_to_memorystores a note in a container the user can edit (put the text inmetadata.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)
| File | Size | Uploaded | |
|---|---|---|---|
| swarmv_mcp-1.2.0.tar.gz | 4.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|