Bear Notes MCP Server

Bear Notes için resmi olmayan, özel görüşlere dayanan bir MCP sunucusu — alt dize eşleştirmesi yerine alakalılık sıralamasına dayalı olarak inşa edilmiştir. Sonuçlar başlıklar, gövdeler ve hiyerarşik etiketler arasında sıralanır, snippet'ler ve birleştirilebilir filtreler (etiket, tarih, sabitlenmiş) içerir. Okuma işlemleri Bear'ın SQLite veritabanına karşı doğrudan çalışır — sorgular için Bear uygulaması gerekli değildir.

Yazma işlemleri Bear'ın kendi URL işleyicisinden geçer — atomiktir ve Bear tarafından doğrulanır. Çevrimdışı-ilk: ağ çağrıları yok, telemetri yok, tüm işlemler Mac'inizde gerçekleşir. Herhangi bir MCP istemcisi ile çalışır — Claude Desktop, Claude Code, Codex, Gemini, Cursor. Tek tıklamalı bir .mcpb uzantısı veya bağımsız bir npm paketi olarak sunulur.

Örnek istekler:

Dışa aktarma boru hatlarında yazdığım derinlemesine incelemeyi bul, #engineering/ altında bir yerde

Bugünün kararlarını haftalık Ops notumun 'Kararlar' bölümüne ekle

#research/llm-evals altındaki her notu bir anket taslağına çek

#blog/drafts ile etiketlenmiş notlarımı bul ve bu haftanın taslak taslağını hazırla

✨ Temel Özellikler

• Varsayılan olarak salt okunur — Düzenleme Modu'nu açarak yazmaları etkinleştir. 4 araç her zaman açık (arama, açma, etiketlenmemiş bulma, etiketleri listele); Düzenleme Modu'nda oluştur, düzenle, ekle, etiketle, arşivle için 8 daha fazla
• Alakalılık sıralaması arama başlıklar, gövdeler ve etiketler arasında — sadece kelimeleri içeren notları değil, doğru notu bulur
• Tarih tabanlı arama göreli tarihlerle ("dün", "geçen hafta", "geçen ayın başı")
• Hiyerarşik etiket yönetimi — etiketleri not sayıları ile bir ağaç olarak görüntüle; tüm kütüphane genelinde bir etiketi yeniden adlandır veya sil
• Cerrah yazmaları — belirli bir başlıkta ekle veya tüm notu yeniden yazmadan bir bölümü değiştir
• Dosya ekleri — resimler, PDF'ler ve 25 MB'a kadar belgeler ekle; güvenlik için sembolik bağlantılar reddedilir
• Yeni not kuralı (opsiyonel) — etiketleri not altkında değil başlığın hemen sonrasına yerleştir
• Yerel-ilk — doğrudan salt okunur SQLite okumalar, yerel node:sqlite, ağ çağrıları yok, telemetri yok

[!NOTE] Tam gizlilik (elbette AI sağlayıcısına bir AI asistanı kullanırken gönderdiğiniz veriler hariç): bu sunucu hiçbir dış bağlantı yapmaz. Tüm işlemler Mac'inizde yerel olarak Bear'ın kendi veritabanı ve API'si kullanılarak gerçekleşir. Ekstra telemetri, kullanım istatistikleri veya bunun gibi bir şey yoktur.

👤 Bu kim için

Bu, resmi olmayan, Bear MCP'ye alternatif bir görüş sağlar. Aşağıdaki durumlarda uygun:

• Yıllarca not aldınız ve alt dize arama yeterli değil. Arama sonuçları alakalılığa göre sıralanır — başlıklar, gövdeler ve tüm kütüphane genelinde etiket eşleşmeleri — böylece doğru not öne çıkar, ifadeniz değişmiş olsa bile.

• MCP istemcileri arasında gidip geliyorsunuz. Stdio taşıması Claude Desktop, Claude Code, Codex CLI, Gemini, Cursor, Windsurf ile çalışır — MCP konuşan her şey. İstemci başına tutkal kodu yok, kilit yok.

• Bear'ı öne çekmeden sorgullamak istiyorsunuz. Okumalar doğrudan Bear'ın SQLite veritabanına karşı çalışır. Hızlı bir arama için Bear'ı açık tutmanız — hatta çalıştırmanız bile gerekmez — konuşmanın ortasında. (Yazmaları Bear aracılığıyla atomik olarak yönlendirir.)

• Tüm kütüphane genelinde etiketleri yönetiyorsunuz. Bir etiketi göründüğü her yerde atomik olarak yeniden adlandır veya sil. Arama sırasında hiyerarşik etiket eşleştirmesi alt etiketleri otomatik olarak devralır — Bear'ın UI'si yalnızca yapması zahmetli olan çalışma.

• Tedarik zinciri hijyeni önemlidir. Yerel node:sqlite — işaretsiz üçüncü taraf ikilileri yok, Gatekeeper sorunları yok. Ağ-serbest sunucu: uzaktan getirme araçları yok, prompt enjeksiyonu yüzeyi yok.

Küçük bir kütüphaneniz varsa ve sadece hızlı bir notlar entegrasyonu istiyorsanız, buna henüz ihtiyacınız olmayabilir.

📦 Kurulum

Claude Desktop Uzantısı

Ön koşullar: Bear uygulaması yüklü olmalı ve Claude Desktop yüklü olmalı.

1. Yayınlar sayfasından en son bear-notes-mcpb-*.mcpb uzantı dosyasını indirin

2. Claude Desktop'ınızın çalıştığından emin olun (değilse başlatın)

3. Uzantı dosyasına çift tıklayın — Claude Desktop kurulum istemini göstermelidir

   Herhangi bir nedenle çift tıklama işe yaramazsa, Claude -> Ayarlar -> Uzantılar -> Gelişmiş Ayarlar -> "Uzantıyı Yükle" seçeneğini tıklayın.

4. BİTTİ!

Claude'dan "Notlarımı Bear'da 'toplantı' için ara" gibi bir sorgu ile Bear notlarınızda arama yapmalarını isteyin - yanıtta notlarınızın görünmesini görmelisiniz!

Bağımsız MCP Sunucusu

Bu Bear Notes MCP sunucusunu Claude Code, Cursor, Codex veya diğer AI asistanları ile kullanmak istiyor musunuz?

Gereksinimler: Node.js 24.13.0+

Claude Code (bir komut)

claude mcp add -s user bear-notes -- npx -y bear-notes-mcp@latest

Diğer AI Asistanları

MCP yapılandırma dosyanıza ekleyin:

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"]
    }
  }
}

Daha fazla kurulum seçeneği ve yerel geliştirme kurulumu — NPM.md

🛠️ Araçlar

• bear-open-note - Bear notunun ID veya başlığına göre tam metin içeriğini okuyun; eklenen resim ve PDF'lerden OCR'ı yapılmış metni içerir
• bear-create-note - Bear kütüphanesi içinde opsiyonel başlık, içerik ve etiketler ile yeni bir not oluşturun
• bear-search-notes - Başlıklar, gövde ve eklenen resim ve PDF'lerden OCR ile ayıklanan metni kapsayan alakalılık yoluyla not bulun. Aradığınızı açıklayan bir ifade veya birkaç anahtar kelime kullanın; sonuçlar alakalılığa göre sıralanır ve her birinde bir bağlam snippet'i vardır. Ayrıca etiket, tarih aralığı ve sabitlenmiş-yalnızca filtreleri destekler — bir arama terimi ile birleştirin veya tarama için kendi başlarına kullanın.
• bear-add-text - Bear notuna başında veya sonunda metin ekleyin veya başlığı ile tanımlanan belirli bir bölümde. Notzun geçerli revizyon tokenini gerektirir (yanıtındaki Revision: N satırı, referans alındığında); eski revizyon karşı yazmaları bear-open-note ile yeniden okumanız ve yeniden denemeleri için bir talimat ile reddedilir.
• bear-replace-text - Mevcut bir Bear notundaki içeriği değiştirin — tam gövde veya belirli bir bölüm. Notzun geçerli revizyon tokenini gerektirir (yanıtındaki Revision: N satırı, referans alındığında); eski revizyon karşı yazmaları bear-open-note ile yeniden okumanız ve yeniden denemeleri için bir talimat ile reddedilir.
• bear-add-file - Yerel bir dosyayı (resim, PDF, belge) ID veya başlığına göre mevcut bir Bear notuna ekleyin. Bear, OCR aracılığıyla resimlerden ve PDF'lerden metin ayıklar, ek içeriğini aranabilir kılar. Notzun geçerli revizyon tokenini gerektirir (yanıtındaki Revision: N satırı, referans alındığında); eski revizyon karşı yazmaları bear-open-note ile yeniden okumanız ve yeniden denemeleri için bir talimat ile reddedilir.
• bear-list-tags - Bear kütüphanesi içindeki tüm etiketleri not sayıları ile hiyerarşik bir ağaç olarak listeleyin
• bear-find-untagged-notes - Bear kütüphanesi içinde atanan etiket olmayan notlar bulun
• bear-add-tag - Mevcut bir Bear notuna bir veya daha fazla etiket ekleyin. Notzun geçerli revizyon tokenini gerektirir (yanıtındaki Revision: N satırı, referans alındığında); eski revizyon karşı yazmaları bear-open-note ile yeniden okumanız ve yeniden denemeleri için bir talimat ile reddedilir.
• bear-archive-note - Bir Bear notunu siliyor olmadan aktif listelerden çıkarmak için arşivleyin
• bear-rename-tag - Bear kütüphanesi içindeki tüm notlar arasında bir etiketi yeniden adlandırın
• bear-delete-tag - Notları etkilemeden Bear kütüphanesi içindeki tüm notlardan bir etiketi silin
• bear-capabilities - Geçerli sunucu modunu (salt okunur veya Düzenleme Modu) ve ek özelliklerin kilidini açma yollarını bildirin

⚙️ Yapılandırma

Hata Ayıklama Günlüğü

Sorun giderme için verbose günlüğü etkinleştirin.

• Claude Desktop: Ayarlar → Uzantılar → Yapılandır (Bear Notes'un yanında) → "Hata Ayıklama Günlüğü" anahtarını aç → Kaydet → Claude'u Yeniden Başlat
• Bağımsız MCP sunucusu: ortam değişkenini ayarla UI_DEBUG_TOGGLE=true

Yeni Not Kuralı

Varsayılan olarak, API aracılığıyla oluşturulduktan sonra Bear etiketleri notz sonuna yerleştirir. Bu seçeneği etkinleştirerek etiketleri başlıktan hemen sonra yatay bir kural tarafından ayrılan olarak yerleştirin.

┌──────────────────────────────┐
│ # Meeting Notes              │  ← Not başlığı
│ #work #meetings              │  ← Başlığın hemen sonrasında etiketler
│                              │
│ ---                          │  ← Ayırıcı
│                              │
│ Lorem Ipsum...               │  ← Not gövdesi
└──────────────────────────────┘

[!TIP] Bu kural varsayılan olarak devre dışı — mevcut davranış korunmak için opsiyoneldir.

• Claude Desktop: Ayarlar → Uzantılar → Yapılandır (Bear Notes'un yanında) → "Yeni Not Kuralı" anahtarını aç → Kaydet → Claude'u Yeniden Başlat
• Bağımsız MCP sunucusu: ortam değişkenini ayarla UI_ENABLE_NEW_NOTE_CONVENTION=true

Kuralı etkinleştirilmiş bağımsız yapılandırma örneği:

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"],
      "env": {
        "UI_ENABLE_NEW_NOTE_CONVENTION": "true"
      }
    }
  }
}

Düzenleme Modu

Düzenleme Modu tüm 8 yazma aracının kilidini açar: notları oluştur, metin ekle veya değiştir (tam gövde veya başlık başına), dosya ekle, etiketleri yönet, arşivle. Kapalı olduğunda, sunucu tamamen salt okunur — tools/list, 4 okuma aracını (bear-open-note, bear-search-notes, bear-find-untagged-notes, bear-list-tags) artı bear-capabilities (istemcilerin MCP instructions alanını bıraktığında bu kilit açma rehberliğini ortaya koyan bir keşif aracı) döndürür. LLM yanlışlıkla kütüphanenizi mutasyona uğratamaz.

[!TIP] Düzenleme Modu kapalı olarak varsayılan yapılır, böylece sunucu kutudan çıkar çıkmaz kanıtlanabilir şekilde salt okunur olur. Yazmalara hazır olduğunuzda açın — ve yalnızca o zaman.

• Claude Desktop: Ayarlar → Uzantılar → Yapılandır (Bear Notes'un yanında) → "Düzenleme Modu" anahtarını aç → Kaydet → Claude'u Yeniden Başlat
• Bağımsız MCP sunucusu: ortam değişkenini ayarla UI_ENABLE_CONTENT_REPLACEMENT=true

Düzenleme Modu etkinleştirilmiş bağımsız yapılandırma örneği:

{
  "mcpServers": {
    "bear-notes": {
      "command": "npx",
      "args": ["-y", "bear-notes-mcp@latest"],
      "env": {
        "UI_ENABLE_CONTENT_REPLACEMENT": "true"
      }
    }
  }
}

Teknik Detaylar

Bu sunucu, arama/okuma işlemleri için Bear Notes SQLite veritabanını doğrudan okur ve yazma işlemleri için Bear'ın X-callback-URL API'sini kullanır. Tüm veri işleme makinenizde yerel olarak gerçekleşir; hiçbir harici ağ çağrısı yok.

Desteklenen Platformlar

Yalnızca macOS, çünkü Bear masaüstü yalnızca macOS'ta çalışır.

Günlükler

Claude Desktop:

• MCP sunucusu günlükleri ~/Library/Logs/Claude/main.log içine gider, bear-notes-mcp ara
• MCP taşıma günlükleri ~/Library/Logs/Claude/mcp-server-Bear\ Notes.log adresine gider

Bağımsız MCP sunucusu:

• Günlükler stderr'e yazılır; UI_DEBUG_TOGGLE=true ile hata ayıklama günlüğü etkinleştirin

SSS

Bu verilerimi çalabilir mi?

Hayır. Sunucu yalnızca Bear'ın yerel veritabanını okur (Bear uygulamasının gösterdiği veriler) ve notlara metin eklemek için Bear'ın yerel API'sini kullanır. Ağ iletişimi yok, harici sunucular yok.

Neden SQLite ve sadece yerel Bear uygulaması x-callback-url API'si değil?

Okuma işlemleri (arama/açma) için, x-callback-url API notu x-success yanıtında döndürür: bu, x-success yanıtlarını işlemek için bir sunucu veya özel ikili gerektirir - her ikisi de riskli ve kırılgan. Doğrudan SQLite salt okunur erişimi, notları aramak ve okumak için daha basit ve güvenilirdir.

Neden üçüncü taraf paketleri yerine yerel Node.js SQLite?

Bu, üçüncü taraf node paketlerinden bir SQLite ikili göndermekten kaçınır, bu da tedarik zinciri riskleri oluşturur ve Claude Desktop uzantısının macOS'ta çalışmasını engeller.

Anthropic açıkça üçüncü taraf SQLite ikililerini imzalamaz, bu da macOS güvenlik sistemlerinin Anthropic tarafından imzalanan Claude işleminin üçüncü taraf tarafından imzalanan başka bir ikiliye çalışmaya çalıştığını işaretlemesine neden olur. Sonuç olarak, Claude Desktop uzantıyı çalıştıramaz.

Uzantıyı kurduğumda kırmızı bir uyarı görüyorum: "Kurulum, bilgisayarınızdaki her şeye erişim izni verecektir." - bu ne anlama geliyor?

Bu, Claude Desktop'ın bu uzantının Mac'inizdeki Bear SQLite veritabanına erişim gerektirmesi gerçeğine nasıl tepki verdiğidir.

Claude uyarı sistemi, sadece bir dosyaya erişim ihtiyacı (uzantının yaptığı budur) ile tüm dosyalara erişim ihtiyacı (bu NE uzantının yaptığıdır) arasında ayrım yapmaz.

Bunu doğrulamanın yollarından biri, uzantıyı kurmadan önce Claude'unuza codebase'i analiz etmelerini (oldukça küçüktür) ve sizin söylemeleridir.

Nasıl hata bildirebilirim veya katkı yapabilirim?

Sorunları veya tartışmaları kullanın! Bu projeyi daha iyi hale getirmek için geri bildiriminizi veya önerilerinizi veya yardımınızı görülmekten mutlu olurum! ❤️

Güncelleme Takibi Kalın

Yeni bir sürüm yayınlandığında bilmek için sürüm açıklamalarına abone olmayı düşünün:

Ayrıca yeni bir sürüm olduğunda reddit.com/r/bearapp/ adresine yazı yazarım.