convez.ai
MCP Server
warlordofmars

hive

warlordofmars/hive

Ver no GitHub
InicialPluginScore · de 0 a 100

Shared persistent memory for AI agents — works with any MCP-compatible client

Instalação

$npx convez-ai warlordofmars/hive

1 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

Estrelas
0
Forks
2
Acompanhando
0
Saúde
85%
Último commit
há 4 meses
Versão
v0.28.2
Issues abertas
58
Contribuidores
3

README

A tradução para o português deste README ainda está na fila.

Hive

CI (main) CI (dev) codecov Ruff mypy

GitHub release GitHub issues GitHub stars

Python uv FastMCP FastAPI AWS Lambda DynamoDB AWS CDK

React Vite Node

MCP

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

  1. Sign in at hive.warlordofmars.net with your Google account
  2. 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:

ToolDescription
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)     │
             └─────────────┘
LayerTechnology
MCP serverFastMCP 3.x (Python)
Auth serverOAuth 2.1 + PKCE (self-contained, built into API Lambda)
Management APIFastAPI (Python)
Management UIReact 18 + Vite
StorageDynamoDB (single-table design)
HostingAWS Lambda Function URLs + CloudFront + S3
IaCAWS CDK (Python)
CI/CDGitHub Actions + OIDC

Documentation

DocDescription
docs/mcp-setup.mdConnecting MCP clients (Claude Code, Claude Desktop, Cursor, and more) to Hive
docs/admin-ui.mdUsing the management UI
Hive management API referenceAuto-generated OpenAPI reference (Scalar) for every REST endpoint
docs/api-reference.mdREST API reference (handwritten, older)
docs/oauth.mdOAuth 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.

Ver o original no GitHub

Bom para

Relacionados