mcpField
A
agentram-mcp

agentram-mcp

ローカル
github.com/seanmarkweiメモリ・ナレッジ011 週間前に更新
リポジトリ

agentram-mcp について

agentram-mcpは、AgentRAMを通じてAIエージェントに永続メモリを提供するMCPサーバーです。通常のメモリと時系列の事実記録を分け、共有スペースや変更履歴にも対応し、ベクトルデータベースや埋め込み処理は不要です。

主な機能

  1. 01キーによるメモリの保存と取得
  2. 02埋め込み不要のテキスト検索
  3. 03名前空間でのメモリ共有
  4. 04事実の変化と履歴の記録
  5. 05現在の事実の競合検出

活用シーン

  1. 01セッションをまたいだコンテキスト保持
  2. 02複数エージェント間でのメモリ共有
  3. 03事実の経時変化の確認

MCP 対応

AgentRAMのメモリ操作をMCPクライアント向けのツールとして公開します。保存、検索、共有スペース、時系列のアサーションを利用できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "seanmarkwei-agentram": {
      "command": "npx",
      "args": [
        "-y",
        "agentram-mcp"
      ],
      "env": {
        "AGENTRAM_API_KEY": "<AGENTRAM_API_KEY>"
      }
    }
  }
}
起動コマンドnpx -y agentram-mcp
設定が必要な環境変数
AGENTRAM_API_KEYシークレットYour AgentRAM API key, starts with agentram_. Get one free at https://agentram.dev

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmagentram-mcp0.1.1

ツール

10

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
keystringはいメモリーのラベル。最大 200 文字。
valuestringはい記憶する内容。最大 5,000 文字。
agent_idstringはいエージェントの一意の識別子。最大 100 文字。
ttl_daysnumberいいえ任意。このメモリーが自動的に期限切れになるまでの日数です。省略すると永続的に保存されます。

詳細

agentram-mcp

AgentRAM 用の MCP サーバーです。ベクトルデータベースも埋め込みパイプラインもセットアップせずに、一連のツールを通じて AI エージェントに永続的なメモリを提供します。キーを取得し、以下の設定を貼り付ければ、約 1 分で使い始められます。

Claude Desktop、Claude Code、Cline、Cursor、Windsurf など、あらゆる MCP クライアントで動作します。

理由

エージェントのセッションは毎回、記憶を失った状態で始まります。AgentRAM はエージェント向けに構築されたプレーンな HTTP メモリストアです。情報を保存する呼び出しと、読み戻す呼び出しをそれぞれ 1 回行うだけです。用意するインフラも、管理するベクトルもありません。このパッケージはその API を MCP ツールとしてラップするため、エージェントはそのまま利用できます。

セットアップ

まず API キーが必要です。agentram.dev で登録すると、キーがメールで届きます。新しいアカウントには 1,000 クレジットが付与され、カードは不要です。

次に、クライアントの MCP 設定に以下を追加します。Claude Desktop の場合、設定ファイルは claude_desktop_config.json です（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json にあります）。

{
  "mcpServers": {
    "agentram": {
      "command": "npx",
      "args": ["-y", "agentram-mcp"],
      "env": {
        "AGENTRAM_API_KEY": "agentram_your_key_here"
      }
    }
  }
}

クライアントを再起動すると、ツールが表示されます。ほとんどのクライアントでは「常に許可」に設定できるため、呼び出しごとに承認をクリックする必要はありません。

macOS での注意点が 1 つあります。Claude Desktop には Node が同梱されていないため、先に Node 18 以降をインストールしないとサーバーが起動しません。

ツール

ツールは 15 個です。フラットメモリ用が 10 個、時間とともに変化する事実を扱う時間的メモリ用が 5 個です。

フラットメモリ：

  • store_memory：エージェントのキーに値を保存します
  • retrieve_memory：キーを指定して値を読み戻します
  • list_memories：エージェントに保存されているすべての情報を一覧表示します
  • search_memories：キーと値をテキスト検索します。埋め込みは不要です
  • delete_memory：情報を 1 件削除します
  • check_credits：現在の残高を確認します。呼び出しは無料です

共有メモリ。同じメモリプールを複数のエージェントで使う場合に利用します：

  • create_namespace：共有スペースを作成します。呼び出しは無料です
  • store_shared_memory：共有スペースに書き込みます
  • retrieve_shared_memory：共有スペースから読み取ります
  • list_shared_memories：共有スペースの内容を一覧表示します

時間的メモリ（アサーション）：

  • store_assertion：計画、ステータス、好みなど、変化する可能性のある事実を記録します
  • retire_assertion：履歴を残したまま、事実が現在は正しくないことを示します
  • get_assertion：キーに関して現在正しいことを取得します
  • list_assertions：エージェントの現在の事実をすべて一覧表示します
  • get_assertion_history：キーの値が時間とともにどのように変化したか、その全履歴を取得します

時間的メモリについて

フラットメモリでは上書きされますが、時間的メモリでは履歴が残ります。事実が変化した場合は、古い値を新しい値で置き換えます。以前の値も残るため、現在の値に至った経緯を確認できます。

知っておくべき点があります。同じキーに異なる 2 つの値が登録され、どちらも他方を置き換えていない場合、get_assertion は一方を黙って選びません。そのキーに競合があることを知らせ、両方の値を返すため、エージェントは推測に頼らず判断できます。list_assertions では、その状態にあるキーにフラグが付きます。

フラットメモリと時間的メモリは、別々のキー空間です。store_memory の plan というキーと、store_assertion の plan というキーに関連性はありません。単に上書きする情報にはフラットメモリを、記録を残したい事実にはアサーションを使います。

クレジット

読み取りと書き込みには、それぞれ 1 クレジットかかります。check_credits と create_namespace は無料です。情報が見つからなかった読み取り（404）では、クレジットが返金されます。ほとんどの応答には credits_remaining が含まれるため、残高を確認できます。

設定

  • AGENTRAM_API_KEY（必須）：キーです。agentram_ で始まります
  • AGENTRAM_API_BASE（任意）：デフォルトは https://api.agentram.dev です

リンク

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。