hive
warlordofmars/hive
Shared persistent memory for AI agents — works with any MCP-compatible client
Instalação
npx convez-ai warlordofmars/hive1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
Hive
Shared persistent memory for AI agents — works with any MCP-compatible client. Free hosted service, no AWS account required.
Hive is an MCP server that gives AI agents durable, shared memory across conversations. Connect any MCP-compatible client — Claude Code, Claude Desktop, ChatGPT, Cursor, Continue, or custom agents — store and retrieve memories by key or tag, and manage everything through a web UI.
Hosted at hive.warlordofmars.net — sign in with Google, no setup required.
Getting started
- Sign in at hive.warlordofmars.net with your Google account
- Connect your MCP client using the config for your client below — OAuth is handled automatically on first use
Claude Code (~/.claude/settings.json) / Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"hive": {
"type": "http",
"url": "https://hive.warlordofmars.net/mcp"
}
}
}
Claude Desktop / ChatGPT — open Settings → Connectors and add a custom MCP connector pointing at:
https://hive.warlordofmars.net/mcp
The browser handles OAuth on first use; no config file or local proxy required.
Older Claude Desktop builds (no Connectors UI) or any other stdio-based client — fall back to mcp-remote as a local proxy:
{
"mcpServers": {
"hive": {
"command": "npx",
"args": ["mcp-remote", "https://hive.warlordofmars.net/mcp"]
}
}
}
OAuth is handled automatically on first use for all of the above. For detailed setup instructions see docs/mcp-setup.md.
What it does
AI agents are stateless — every new conversation starts blank. Hive gives them a persistent, shared memory store:
| Tool | Description |
|---|---|
remember(key, value, tags[]) | Store a memory |
recall(key) | Retrieve a memory by key |
forget(key) | Delete a memory |
list_memories(tag) | List memories by tag |
summarize_context(topic) | Synthesize memories on a topic into a summary |
Multiple agents or team members connect with their own OAuth clients, so you can track who stored what and revoke access individually.
Keys are opaque to the server, but a structured convention like {domain}:{entity-type}/{entity-id}:{attribute} (e.g. project:task/42:summary) keeps memory stores organised and collision-free as they grow. See the key naming conventions docs page for details.
Architecture
Hive is a serverless, AWS-native stack deployed on Lambda + DynamoDB behind CloudFront:
MCP client (Claude Code, Cursor, …)
│ MCP / Streamable HTTP
▼
┌──────────────────────────────────────────────┐
│ CloudFront │
│ hive.warlordofmars.net │
│ │
│ /mcp → MCP Lambda (FastMCP) │
│ /api/* /oauth/* → API Lambda (FastAPI) │
│ / → S3 (React SPA) │
└──────────────────────────────────────────────┘
│ │
└──────────┬────────────┘
▼
┌─────────────┐
│ DynamoDB │
│ (hive) │
└─────────────┘
| Layer | Technology |
|---|---|
| MCP server | FastMCP 3.x (Python) |
| Auth server | OAuth 2.1 + PKCE (self-contained, built into API Lambda) |
| Management API | FastAPI (Python) |
| Management UI | React 18 + Vite |
| Storage | DynamoDB (single-table design) |
| Hosting | AWS Lambda Function URLs + CloudFront + S3 |
| IaC | AWS CDK (Python) |
| CI/CD | GitHub Actions + OIDC |
Documentation
| Doc | Description |
|---|---|
| docs/mcp-setup.md | Connecting MCP clients (Claude Code, Claude Desktop, Cursor, and more) to Hive |
| docs/admin-ui.md | Using the management UI |
| Hive management API reference | Auto-generated OpenAPI reference (Scalar) for every REST endpoint |
| docs/api-reference.md | REST API reference (handwritten, older) |
| docs/oauth.md | OAuth 2.1 implementation details |
Contributing
Contributions are welcome. See CONTRIBUTING.md for local dev setup, the test workflow, and how to submit a PR.
git clone https://github.com/warlordofmars/hive
cd hive
uv sync --all-extras # install Python deps (requires uv)
cd ui && npm install # install JS deps
uv run inv pre-push # lint + type check + unit tests + frontend tests
Security
To report a vulnerability, use GitHub's private vulnerability reporting rather than opening a public issue. See SECURITY.md for the full disclosure policy.