English Français العربية

io.github.bluecolumnconsulting-lgtm/bluecolumn-memory

السجل الرسمي الوسائط والتصميم

Persistent memory for AI agents — audio intelligence + Music Memory ingestion and recall

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package bluecolumn-mcp
Claude Code 
claude mcp add bluecolumn-memory -e 'BLUECOLUMN_API_KEY=<your bluecolumn_api_key>' -e 'BLUECOLUMN_API_URL=<BLUECOLUMN_API_URL>' -- npx -y bluecolumn-mcp@1.4.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bluecolumn-memory": {
            "command": "npx",
            "args": [
                "-y",
                "bluecolumn-mcp@1.4.0"
            ],
            "env": {
                "BLUECOLUMN_API_KEY": "<your bluecolumn_api_key>",
                "BLUECOLUMN_API_URL": "<BLUECOLUMN_API_URL>"
            }
        }
    }
}

متغيرات البيئة

  • BLUECOLUMN_API_KEY إلزامي سري Your BlueColumn API key. Get a free key at https://bluecolumn.ai
  • BLUECOLUMN_API_URL BlueColumn API base URL for the audio-intelligence layer (/v1/audio/*, /v1/calls/*, /v1/sound/*, /v1/music/*). Defaults to http://localhost:8000 (local FastAPI backend).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. 🧠 BlueColumn MCP Server
  2. Tools
  3. Music Memory example
  4. Setup
  5. What Makes BlueColumn Different
  6. Examples
  7. Advanced

🧠 BlueColumn MCP Server

Give Claude Desktop, Cursor, and any MCP-compatible agent persistent memory across sessions.

2-minute setup. Zero-config. Audio-native. Works with every MCP client.

MCP server for BlueColumn — persistent semantic memory for AI agents.

Give any MCP-compatible agent (Claude Desktop, Cursor, Windsurf, LangChain, AutoGen, CrewAI) the ability to remember, recall, and store observations across sessions.

Tools

Core memory
ToolDescription
rememberIngest text, audio, or documents into persistent memory
recallQuery memory with natural language, get AI-synthesized answer + sources
noteStore lightweight agent observations as searchable vectors
namespaceShow the configured namespace
Music Memory (new)
ToolDescription
music_rememberStore a musical recording, practice session, or lesson with rich musical context — instrument, key, tempo, technique tags, chord progression, notes. Audio is transcribed; the structured context is embedded alongside so a coach/teacher agent recalls it with full musical understanding
music_recallSearch stored musical content with musical filters — instrument, technique, or style. E.g. "show me every take with barre chord issues" or "what did we practice in E minor last month"
Audio Intelligence
ToolDescription
audio_ingestIngest calls, voice notes, podcasts, meetings, or music and extract semantic memory
audio_recallSearch audio memories and get audio-backed citations
call_prepareGet memory context before a voice call starts
call_completeStore what changed after a call ends
sound_analyzeDetect and index non-speech audio events
music_analyzeExtract tempo, structure, instrumentation, mood from music
Streaming audio memory
ToolDescription
streaming_audio_ingestIngest edge-device audio chunks (car, doorbell, wearable) into per-device streaming memory
streaming_audio_recallRecall over a device's streamed audio history

Music Memory example

Store a practice session:

music_remember {
  "audio_url": "https://example.com/take3.mp3",
  "title": "Week 3 practice — barre chords, Sep 7",
  "instrument": "guitar",
  "musical_key": "E minor",
  "tempo_bpm": 92,
  "technique_tags": ["barre-chords", "hammer-on"],
  "style_tags": ["blues"],
  "chord_progression": ["Em", "Am", "B7"],
  "notes": "F-shape barre still buzzy on the B string; Fmaj7 subst worked well"
}

Then recall it musically:

music_recall { "q": "which takes had barre chord issues?", "instrument": "guitar" }

Setup

1. Get your BlueColumn API key

Sign up free at bluecolumn.ai — 60 min audio + 100 queries/month, no credit card required.

2. Install
npm install -g bluecolumn-mcp
3. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bluecolumn": {
      "command": "bluecolumn-mcp",
      "env": {
        "BLUECOLUMN_API_KEY": "bc_live_YOUR_KEY"
      }
    }
  }
}
4. Restart Claude

Done. Claude now remembers everything you tell it to.

What Makes BlueColumn Different

FeatureBlueColumn MCPOther MCP Memory Servers
Audio ingestion✅ Native (transcribe + store)❌ Text only
Plain English recall✅ "What did we decide about pricing?"❌ Keyword/vector only
Setup time~2 minutes~10-30 minutes
Cloud managed✅ No infra to run⚠️ Most require local DB
Namespace isolation✅ Built-in per key⚠️ Manual

Examples

Store project context
Remember: We're building a React component library called Aether with Tailwind CSS v4.
Recall across sessions (new conversation)
What project was I working on? What was my tech stack?

→ Claude recalls: "You're building Aether, a React component library with Tailwind CSS v4"

Store audio notes

Record a voice memo → BlueColumn transcribes it → Claude remembers it.

Advanced

Custom namespace
{
  "mcpServers": {
    "bluecolumn": {
      "command": "bluecolumn-mcp",
      "env": {
        "BLUECOLUMN_API_KEY": "bc_live_YOUR_KEY",
        "BLUECOLUMN_NAMESPACE": "my_project"
      }
    }
  }
}
Multiple environments

Use different namespaces for work, personal, and side projects. Each stays isolated.

Sign up free → · Docs · GitHub Issues

الأسئلة الشائعة

ما هو io.github.bluecolumnconsulting-lgtm/bluecolumn-memory؟

Persistent memory for AI agents — audio intelligence + Music Memory ingestion and recall

كيف أثبّت io.github.bluecolumnconsulting-lgtm/bluecolumn-memory؟

يعمل على جهازك. في Claude Code: claude mcp add bluecolumn-memory -e 'BLUECOLUMN_API_KEY=<your bluecolumn_api_key>' -e 'BLUECOLUMN_API_URL=<BLUECOLUMN_API_URL>' -- npx -y bluecolumn-mcp@1.4.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.bluecolumnconsulting-lgtm/bluecolumn-memory إلى مفتاح API؟

نعم. يتطلب BLUECOLUMN_API_KEY، وتضبطها في إعداداته.

هل io.github.bluecolumnconsulting-lgtm/bluecolumn-memory مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.bluecolumnconsulting-lgtm/bluecolumn-memory؟

ينشره bluecolumnconsulting-lgtm. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.