memory

@sharedmemory/mcp-server

SharedMemory 用の Model Context Protocol サーバーです。Claude Code、Claude Desktop、Cursor、VS Code Copilot、その他の MCP 対応ツールに永続的なメモリを提供します。

クイックインストール（推奨）

SharedMemory を最もすばやくセットアップできます。コマンドは 1 つだけで、JSON の編集は不要です。

# 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_...

対応クライアント：--claude-code、--claude、--cursor、--vscode、--windsurf、--all

手動セットアップ

設定ファイルを自分で編集する場合は、以下の手順に従ってください。

Claude Code

コマンド 1 つで設定できます。

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

または、環境変数を指定します。

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

チームと共有するには、プロジェクトのルートに .mcp.json を作成します。

{
  "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}"
      }
    }
  }
}

ヒント： 同梱の CLAUDE.md をプロジェクトのルートにコピーすると、SharedMemory を積極的に使用するタイミングと方法を Claude Code に教えられます。

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：

{
  "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"
      }
    }
  }
}

設定

変数	必須	デフォルト	説明
SHAREDMEMORY_API_KEY	はい	—	エージェント API キー
SHAREDMEMORY_API_URL	いいえ	https://api.sharedmemory.ai	API エンドポイント
SHAREDMEMORY_VOLUME_ID	いいえ	—	デフォルトのボリューム

利用可能なツール

ツール	説明
remember	事実やメモを保存します
query	回答する前にコンテキストを取得します — メモリを対象としたセマンティック検索
get_entity	エンティティの詳細と関係を取得します
search_entities	名前でエンティティを検索します
get_graph	ナレッジグラフの概要を取得します
list_volumes	アクセス可能なボリュームを一覧表示します
delete_memory	ID でメモリを削除します
update_memory	ID でメモリを更新します
feedback	メモリの関連性に関するフィードバックを送信します
batch_remember	複数のメモリを一度に保存します
get_memory	ID で特定のメモリを取得します
get_profile	メモリから自動生成されたユーザープロファイルを取得します
get_context	LLM のプロンプト用にコンテキストブロックを取得します
set_instruction	すべてのエージェントが従う永続的なルールを保存します
list_instructions	ボリューム内の有効な指示をすべて一覧表示します
list_documents	アップロード済みのドキュメントを一覧表示します

リソース

URI	説明
memory://graph	デフォルトのボリュームのナレッジグラフ

プロンプト

名前	説明
summarize-knowledge	ボリューム内のすべてのナレッジを要約します
what-do-you-know-about	トピックについて把握している情報をすべて取得します

ドキュメント

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

ライセンス

MIT