English Français العربية

io.github.sharedmemoryai/memory

السجل الرسمي الذكاء الاصطناعي والوكلاء

Persistent memory for AI agents. Remember, recall, and explore a shared knowledge graph.

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

التثبيت

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

NPM package @sharedmemory/mcp-server
Claude Code 
claude mcp add memory -e 'SHAREDMEMORY_API_KEY=<your sharedmemory_api_key>' -e 'SHAREDMEMORY_API_URL=<SHAREDMEMORY_API_URL>' -e 'SHAREDMEMORY_VOLUME_ID=<SHAREDMEMORY_VOLUME_ID>' -- npx -y @sharedmemory/mcp-server@2.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "memory": {
            "command": "npx",
            "args": [
                "-y",
                "@sharedmemory/mcp-server@2.1.1"
            ],
            "env": {
                "SHAREDMEMORY_API_KEY": "<your sharedmemory_api_key>",
                "SHAREDMEMORY_API_URL": "<SHAREDMEMORY_API_URL>",
                "SHAREDMEMORY_VOLUME_ID": "<SHAREDMEMORY_VOLUME_ID>"
            }
        }
    }
}

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

  • SHAREDMEMORY_API_KEY إلزامي سري Your SharedMemory API key
  • SHAREDMEMORY_API_URL API endpoint URL
  • SHAREDMEMORY_VOLUME_ID Default volume/project ID

التوثيق

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

المحتويات
  1. @sharedmemory/mcp-server
  2. Quick Install (Recommended)
  3. Manual Setup
  4. Configuration
  5. Available tools
  6. Resources
  7. Prompts
  8. Documentation
  9. License

@sharedmemory/mcp-server

Model Context Protocol server for SharedMemory. Gives Claude Code, Claude Desktop, Cursor, VS Code Copilot, and other MCP-compatible tools persistent memory.

The fastest way to set up SharedMemory — one command, no JSON editing:

# Interactive — picks your client, asks for your API key
npx -y @sharedmemory/mcp-server install

# Or specify everything inline
npx -y @sharedmemory/mcp-server install --cursor --api-key sm_live_... --volume your-volume-id

# Install for all supported clients at once
npx -y @sharedmemory/mcp-server install --all --api-key sm_live_...

Supported clients: --claude-code, --claude, --cursor, --vscode, --windsurf, --all

Manual Setup

If you prefer to edit config files yourself:

Claude Code

One command:

claude mcp add sharedmemory -- npx -y @sharedmemory/mcp-server

Or with env vars:

claude mcp add --env SHAREDMEMORY_API_KEY=sm_live_... \
  --env SHAREDMEMORY_VOLUME_ID=your-volume-id \
  sharedmemory -- npx -y @sharedmemory/mcp-server

Or create .mcp.json in your project root to share with your team:

{
  "mcpServers": {
    "sharedmemory": {
      "command": "npx",
      "args": ["-y", "@sharedmemory/mcp-server"],
      "env": {
        "SHAREDMEMORY_API_KEY": "${SHAREDMEMORY_API_KEY}",
        "SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
        "SHAREDMEMORY_VOLUME_ID": "${SHAREDMEMORY_VOLUME_ID}"
      }
    }
  }
}

Tip: Copy the included CLAUDE.md into your project root to teach Claude Code when and how to use SharedMemory proactively.

Claude Desktop

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

{
  "mcpServers": {
    "sharedmemory": {
      "command": "npx",
      "args": ["-y", "@sharedmemory/mcp-server"],
      "env": {
        "SHAREDMEMORY_API_KEY": "sm_live_...",
        "SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
        "SHAREDMEMORY_VOLUME_ID": "your-volume-id"
      }
    }
  }
}
Cursor

.cursor/mcp.json in your project root:

{
  "mcpServers": {
    "sharedmemory": {
      "command": "npx",
      "args": ["-y", "@sharedmemory/mcp-server"],
      "env": {
        "SHAREDMEMORY_API_KEY": "sm_live_...",
        "SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
        "SHAREDMEMORY_VOLUME_ID": "your-volume-id"
      }
    }
  }
}
VS Code Copilot

.vscode/mcp.json:

{
  "servers": {
    "sharedmemory": {
      "command": "npx",
      "args": ["-y", "@sharedmemory/mcp-server"],
      "env": {
        "SHAREDMEMORY_API_KEY": "sm_live_...",
        "SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
        "SHAREDMEMORY_VOLUME_ID": "your-volume-id"
      }
    }
  }
}
Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "sharedmemory": {
      "command": "npx",
      "args": ["-y", "@sharedmemory/mcp-server"],
      "env": {
        "SHAREDMEMORY_API_KEY": "sm_live_...",
        "SHAREDMEMORY_API_URL": "https://api.sharedmemory.ai",
        "SHAREDMEMORY_VOLUME_ID": "your-volume-id"
      }
    }
  }
}

Configuration

VariableRequiredDefaultDescription
SHAREDMEMORY_API_KEYYes—Agent API key
SHAREDMEMORY_API_URLNohttps://api.sharedmemory.aiAPI endpoint
SHAREDMEMORY_VOLUME_IDNo—Default volume

Available tools

ToolDescription
rememberStore a fact or note
queryRetrieve context BEFORE answering — semantic search over memories
get_entityGet entity details and relationships
search_entitiesSearch entities by name
get_graphKnowledge graph overview
list_volumesList accessible volumes
delete_memoryDelete a memory by ID
update_memoryUpdate a memory by ID
feedbackSubmit feedback on memory relevance
batch_rememberStore multiple memories at once
get_memoryRetrieve a specific memory by ID
get_profileAuto-generated user profile from memories
get_contextGet a context block for LLM prompting
set_instructionStore a persistent rule all agents will follow
list_instructionsList all active instructions for a volume
list_documentsList uploaded documents

Resources

URIDescription
memory://graphKnowledge graph for the default volume

Prompts

NameDescription
summarize-knowledgeSummarize all knowledge in a volume
what-do-you-know-aboutRetrieve everything known about a topic

Documentation

https://docs.sharedmemory.ai/sdks/mcp-server

License

MIT

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

ما هو io.github.sharedmemoryai/memory؟

Persistent memory for AI agents. Remember, recall, and explore a shared knowledge graph.

كيف أثبّت io.github.sharedmemoryai/memory؟

يعمل على جهازك. في Claude Code: claude mcp add memory -e 'SHAREDMEMORY_API_KEY=<your sharedmemory_api_key>' -e 'SHAREDMEMORY_API_URL=<SHAREDMEMORY_API_URL>' -e 'SHAREDMEMORY_VOLUME_ID=<SHAREDMEMORY_VOLUME_ID>' -- npx -y @sharedmemory/mcp-server@2.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.sharedmemoryai/memory إلى مفتاح API؟

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

هل io.github.sharedmemoryai/memory مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.sharedmemoryai/memory؟

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

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