Skip to main content

tibet-voice-cache-mcp

MCP server for persistent voice conversation memory. Plug into Claude Code, Cursor, Windsurf, or any MCP client.

pip install tibet-voice-cache-mcp

What it does

Gives any MCP-compatible AI client tools to store and recall voice conversation context. User and AI utterances are stored separately in RAM (or optionally on disk) and formatted as clean context summaries — no fake turns, no role confusion.

┌──────────────────────────────────────────────────────────────┐
│  MCP Client (Claude Code / Cursor / Windsurf / etc.)         │
│                                                              │
│  voice_cache_add(actor="user_1", text="...", role="user")    │
│  voice_cache_add(actor="user_1", text="...", role="ai")      │
│  voice_cache_turn(actor="user_1")                            │
│                                                              │
│  voice_cache_inject(actor="user_1",                          │
│    base_instruction="You are a voice assistant.")            │
│  → "You are a voice assistant.                               │
│                                                              │
│     === PRIOR CONTEXT ===                                    │
│     The user previously said:                                │
│       - What's the weather?                                  │
│     You previously responded:                                │
│       - Sunny and 22 degrees!                                │
│     === END CONTEXT ==="                                     │
└──────────────────────────────────────────────────────────────┘

Setup

Claude Code

// ~/.claude.json
{
  "mcpServers": {
    "voice-cache": {
      "command": "tibet-voice-cache-mcp"
    }
  }
}

With disk persistence

{
  "mcpServers": {
    "voice-cache": {
      "command": "tibet-voice-cache-mcp",
      "env": {
        "VOICE_CACHE_DIR": "/path/to/cache"
      }
    }
  }
}

Cursor / Windsurf

Same pattern — add tibet-voice-cache-mcp as an MCP server command.

Tools

Tool Description
voice_cache_status List all active caches with stats
voice_cache_open Open/create cache for an actor
voice_cache_add Record user or AI utterance
voice_cache_turn Mark turn boundary
voice_cache_context Get formatted context summary
voice_cache_inject Inject context into system instruction
voice_cache_session Bulk import session transcripts
voice_cache_history View cached utterances
voice_cache_clear Clear cache for an actor
voice_cache_configure Change summary style / language

Quick workflow

# During voice session
voice_cache_open(actor="user_123")
voice_cache_add(actor="user_123", text="What's the weather?", role="user")
voice_cache_add(actor="user_123", text="Sunny and warm!", role="ai")
voice_cache_turn(actor="user_123")

# Next session — inject memory
voice_cache_inject(
    actor="user_123",
    base_instruction="You are a friendly weather assistant."
)

Summary styles

Configure how context is formatted:

voice_cache_configure(actor="user_123", summary_style="compact")
Style Format
labeled Sectioned with headers (default)
compact Minimal tokens, single-line
narrative Natural language, conversational
chronological Numbered turn pairs

Multi-language

voice_cache_configure(actor="user_123", language="nl")

Built-in: English (en), Dutch (nl).

Environment variables

Variable Default Description
VOICE_CACHE_DIR (none — RAM only) Directory for JSON persistence
VOICE_CACHE_MAX_TURNS 50 Max utterances per side before trimming
VOICE_CACHE_STYLE labeled Default summary style

Resources

The server also exposes MCP resources:

  • voice-cache://actors — List all actors with open caches
  • voice-cache://actor/{name} — Full cache content for an actor

Part of the TIBET ecosystem

Package Description
tibet-voice-cache Core library — voice conversation memory
tibet-voice-cache-mcp This package — MCP server wrapper

License

MIT — plug it in, give your voice AI a memory.

Metadata

Release files for tibet-voice-cache-mcp 0.1.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 tibet-voice-cache-mcp 0.1.0
File Size Uploaded
tibet_voice_cache_mcp-0.1.0.tar.gz 6.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tibet-voice-cache-mcp 0.1.0
File Interpreter ABI Platform
tibet_voice_cache_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 15.2 kB

Release files / tibet_voice_cache_mcp-0.1.0.tar.gz

Download URL tibet_voice_cache_mcp-0.1.0.tar.gz
Size 6.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b6bdb890a7a5f54f56b68c1622fad1c4cdd2b76634d4c3f235f5c00b878504ab
BLAKE2b-256 checksum
How to use checksums
8300e2c5ebce5259c37378d6e083105d4878946c7b73438c1f12c3f914d238c6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / tibet_voice_cache_mcp-0.1.0-py3-none-any.whl

Download URL tibet_voice_cache_mcp-0.1.0-py3-none-any.whl
Size 8.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cf0b369948c5e60cf6471b40706af1169f853ba45b994f6e2ef37c4b3be8bc7b
BLAKE2b-256 checksum
How to use checksums
91ee9f9a777e3437f3a686a91d719686d6033e81275c31f8cda5226286b729f7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

0.1.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