Memstate AI MCP Server

Memstate AI - MCP

Yapay zeka ajanları için sürümlü bellek. Gerçekleri saklayın, çakışmaları tespit edin ve kararların zaman içinde nasıl değiştiğini izleyin — barındırılan bir MCP sunucusu olarak sunulur.

Panel · Dokümanlar · Fiyatlandırma

---

Neden Memstate?

	RAG (diğer çoğu bellek sistemi)	Memstate AI
Konuşma başına token kullanımı	~7.500	~1.500
Ajan görünürlüğü	Kara kutu	Tam şeffaflık
Bellek sürümleme	Yok	Tam geçmiş
Bellekler ölçeklendikçe token artışı	O(n)	O(1)
Altyapı gerekli mi	Evet	Yok — barındırılan SaaS

Diğer bellek sistemleri her şeyi bağlam pencerenize döküp en iyisini umar. Memstate, ajanınıza tam olarak gezinebileceği yapılandırılmış, sürümlü bir bilgi tabanı sunar — yalnızca ihtiyacınız olanı yükleyin, neyin değiştiğini bilin, gerçekler ne zaman çakışır bilin.

---

Kıyaslamalar

Ajan belleği için gerçekten önemli olanı test eden açık kaynaklı bir kıyaslama paketi oluşturduk: sisteminiz gerçekleri saklayabilir, oturumlar arasında doğru şekilde hatırlayabilir, işler değiştiğinde çakışmaları tespit edebilir ve bir proje geliştikçe bağlamı koruyabilir mi?

Bire Bir: Memstate AI vs Mem0

Her iki sistem de aynı ajan (Claude Sonnet 4.6, sıcaklık 0), aynı senaryolar ve aynı puanlama rubriği kullanılarak özdeş koşullar altında test edildi.

Metrik	Memstate AI	Mem0	Kazanan
Genel Puan	69.1	15.4	Memstate
Doğruluk (gerçek hatırlama)	74.1	12.6	Memstate
Çakışma Tespiti	85.5	19.0	Memstate
Bağlam Sürekliliği	63.7	10.1	Memstate
Token Verimliliği	22.3	30.6	Mem0

Puanlama ağırlıkları: Doğruluk %40, Çakışma Tespiti %25, Bağlam Sürekliliği %25, Token Verimliliği %10.

Senaryo Bazında Dağılım

Kıyaslama, çok oturumlu ajan iş akışlarını simüle eden beş gerçek dünya senaryosunu çalıştırır:

Senaryo	Memstate AI	Mem0
Web Uygulaması Mimari Evrimi	43.2	55.6
Kimlik Doğrulama Sistemi Geçişi	66.2	10.2
Veritabanı Şeması Evrimi	72.7	7.0
API Sürümleme Çakışmaları	86.5	0.9
Takım Kararının Tersine Çevrilmesi	77.2	3.3

Mem0 ilk senaryoyu (basit mimari takibi) kazandı, ancak çelişki yönetimi, oturumlar arası bağlam ve karar tersine çevirme takibi gerektiren senaryolarda ciddi şekilde zorlandı — beş senaryonun üçünde neredeyse sıfır puan aldı.

Memstate Neden Kazanıyor

Kıyaslama, temel bir mimari farkı ortaya koyuyor:

Mem0, gömme tabanlı anlamsal arama kullanır. Gerçekler parçalanır, gömülür ve benzerliğe göre getirilir. Bu, basit aramalar için işe yarar ancak şu durumlarda bozulur:

• Gerçekler önceki gerçeklerle çeliştiğinde (sistem güncel ile güncel olmayanı ayırt edemez)
• Kesin hatırlama gerektiğinde (gömmeler "benzer" sonuçlar döndürür, tam olanları değil)
• Yazmadan okumaya gecikme önemli olduğunda (yeni anıların aranabilir hale gelmesi saniyeler alır)

Memstate, yapılandırılmış, sürümlü anahtar-değer depolama kullanır. Her gerçek, tam sürüm geçmişiyle birlikte açık bir anahtar yolunda bulunur. Bu şu anlama gelir:

• Çakışma tespiti yerleşiktir — yeni bir gerçek eski bir gerçekle çeliştiğinde, sistem bunu bilir ve her iki sürümü de korur
• Hatırlama deterministiktir — tam olarak ne saklandıysa geri alırsınız, yaklaşık bir eşleşme değil
• Oturumlar arası süreklilik güvenilirdir — ajan, anlamsal aramanın doğru bağlamı yüzeye çıkarmasını ummak yerine yapılandırılmış bir ağaçta gezinir
• Token maliyeti O(1) kalır — ajan, potansiyel olarak ilgili tüm gömmeleri bağlam penceresine dökmek yerine önce özetleri yükler ve yalnızca gerektiğinde ayrıntıya iner

Adillik Notları

• Her iki sistem de aynı ajan modelini, sıcaklığı ve değerlendirme rubriğini kullandı
• Mem0'a, eşzamansız gömme hattını hesaba katmak için yazma ve okuma arasında 10 saniyelik bir alım gecikmesi verildi
• Mem0 token verimliliğinde daha yüksek puan alır, ancak bu metrik bağlam içinde okunmalıdır — daha düşük token kullanımı, basitçe daha az bilgi döndürüldüğünü yansıtabilir. Eksik veya yanlış gerçekleri getiren bir sistem yanıt başına daha az token kullanır ancak aynı cevaba ulaşmak için daha fazla takip çağrısı gerektirebilir ve nihayetinde daha fazla token harcar
• Kıyaslama kaynak kodu, tam tekrarlanabilirlik için bu depoda yer almaktadır
• Mem0, özel yapılandırma veya farklı bir gömme modeli ile farklı performans gösterebilir

---

Hızlı Başlangıç

API anahtarınızı memstate.ai/dashboard adresinden alın, ardından MCP istemci yapılandırmanıza ekleyin:

{
  "mcpServers": {
    "memstate": {
      "command": "npx",
      "args": ["-y", "@memstate/mcp"],
      "env": {
        "MEMSTATE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Docker yok. Veritabanı yok. Altyapı yok. 60 saniyede çalışır.

---

İstemci Kurulumu

Claude Desktop

Yapılandırma konumu:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memstate": {
      "command": "npx",
      "args": ["-y", "@memstate/mcp"],
      "env": { "MEMSTATE_API_KEY": "YOUR_API_KEY_HERE" }
    }
  }
}

Claude Code

claude mcp add memstate npx @memstate/mcp -e MEMSTATE_API_KEY=YOUR_API_KEY_HERE

Cursor

Cursor Ayarları → MCP → Sunucu Ekle — yukarıdaki Claude Desktop ile aynı JSON formatı.

Cline / Windsurf / Kilo Code / Roo Code

Tümü aynı stdio MCP yapılandırma formatını destekler. İstemcinizin MCP ayarlar dosyasına ekleyin.

---

Temel Araçlar

Araç	Ne zaman kullanılır
memstate_remember	Markdown, görev özetleri, kararlar saklayın. Sunucu anahtar yollarını otomatik olarak çıkarır ve çakışmaları tespit eder. Çoğu yazma işlemi için kullanın.
memstate_set	Tek bir anahtar yoluna kısa bir değer atayın (örn. config.port = 8080). Düz yazı için değil.
memstate_get	Bir proje veya alt ağaç için tüm anılara göz atın. Her görevin başında kullanın.
memstate_search	Tam anahtar yolunu bilmediğinizde anlama göre anlamsal arama.
memstate_history	Bir bilgi parçasının zaman içinde nasıl değiştiğini görün — tam sürüm zinciri.
memstate_delete	Bir anahtar yolunu geçici olarak silin. Bir mezar taşı oluşturur; tam geçmiş korunur.
memstate_delete_project	Tüm bir projeyi ve tüm anılarını geçici olarak silin.

Anahtar yolları nasıl çalışır

Anılar, hiyerarşik nokta gösterimiyle düzenlenir:

project.my_app.database.schema
project.my_app.auth.provider
project.my_app.deploy.environment

Anahtar yolları otomatik olarak ön eklenir: keypath="database" ile project_id="my_app" → project.my_app.database. Ajanınız tam olarak ihtiyacı olana inebilir — tam bağlam dökümleri yok.

---

Nasıl Çalışır

Agent: memstate_remember(project_id="my_app", content="## Auth\nUsing SuperTokens...")
         ↓
Server extracts keypaths:  [project.my_app.auth.provider, ...]
         ↓
Conflict detection:  compare against existing memories at those keypaths
         ↓
New version stored — old version preserved in history chain
         ↓
Next session: memstate_get(project_id="my_app") → structured summaries only
         ↓
Agent drills into project.my_app.auth only when it needs auth details

Toplamda kaç anı var olursa olsun token maliyeti sabit kalır.

---

Ajan Talimatlarınıza Ekleyin

AGENTS.md veya sistem isteminize kopyalayın:

## Memory (Memstate MCP)

### Before each task
- memstate_get(project_id="my_project") — browse existing knowledge
- memstate_search(query="topic", project_id="my_project") — find by meaning

### After each task
- memstate_remember(project_id="my_project", content="## Summary\n- ...", source="agent")

### Tool guide
- memstate_remember — markdown summaries, decisions, task results (preferred)
- memstate_set — single short values only (config flags, status)
- memstate_get — browse/retrieve before tasks
- memstate_search — semantic lookup when keypath unknown
- memstate_history — audit how knowledge evolved
- memstate_delete — remove outdated memories (history preserved)

---

Ortam Değişkenleri

Değişken	Varsayılan	Açıklama
MEMSTATE_API_KEY	(gerekli)	memstate.ai/dashboard adresinden API anahtarı
MEMSTATE_MCP_URL	https://mcp.memstate.ai	Kendi kendine barındırılan dağıtımlar için geçersiz kılma

Bağlantınızı Doğrulayın

MEMSTATE_API_KEY=your_key npx @memstate/mcp --test

Mevcut tüm araçları yazdırır ve API anahtarınızın çalıştığını onaylar.

Ne bildiklerini bilmeyi hak eden yapay zeka ajanları için inşa edildi.