iMessage Query MCP Server

Model Context Protocol (MCP) aracılığıyla iMessage veritabanınıza güvenli erişim sağlayan bir MCP sunucusu. Bu sunucu FastMCP framework'ü ve imessagedb kütüphanesi ile kurulmuş olup, LLM'lerin uygun telefon numarası doğrulaması ve ek dosya işleme ile iMessage konuşmalarını sorgulamasını ve analiz etmesini sağlar.

📋 Sistem Gereksinimleri

• macOS (iMessage veritabanı erişimi için gerekli)
• Python 3.6+

📦 Bağımlılıklar

Tüm gerekli bağımlılıkları yükleyin:

# pip kullanarak
pip install -r requirements.txt

Gerekli Paketler

• fastmcp: Model Context Protocol sunucuları oluşturmak için framework
• imessagedb: macOS Messages veritabanına erişmek ve sorgulamak için Python kütüphanesi
• phonenumbers: Uygun telefon numarası doğrulaması ve biçimlendirmesi için Google'ın telefon numarası işleme kütüphanesi

Tüm bağımlılıklar kolay kurulum için requirements.txt dosyasında belirtilmiştir.

📑 İçindekiler

• Sistem Gereksinimleri
• Bağımlılıklar
• MCP Araçları
• Başlangıç
• Kurulum Seçenekleri
  • Claude Desktop
  • Cline VSCode Plugin
• Güvenlik Özellikleri
• Geliştirme Dokümantasyonu
• Ortam Değişkenleri

🛠️ MCP Araçları

Sunucu, LLM'lere aşağıdaki araçları sunar:

get_chat_transcript

Belirli bir telefon numarası için isteğe bağlı tarih filtrelemesi ile mesaj geçmişini alın. Şunları içerir:

• Mesaj metni ve zaman damgaları
• Ek dosya bilgileri (varsa)
• Uygun telefon numarası doğrulaması
• Tarih aralığı filtrelemesi

🚀 Başlangıç

Depoyu klonlayın:

git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git
cd imessage-query-fastmcp-mcp-server

📦 Kurulum Seçenekleri

Bu MCP sunucusunu Claude Desktop veya Cline VSCode plugin'inde kurabilirsiniz. İhtiyaçlarınıza en uygun seçeneği seçin.

Seçenek 1: Claude Desktop için Kurulum

FastMCP kullanarak kurun:

fastmcp install imessage-query-server.py --name "iMessage Query"

Seçenek 2: Cline VSCode Plugin için Kurulum

Bu sunucuyu Cline VSCode plugin ile kullanmak için:

1. VSCode'da Cline plugin kenar çubuğundaki sunucu simgesine (☰) tıklayın
2. "MCP Ayarlarını Düzenle" düğmesine (✎) tıklayın
3. Ayarlar dosyasına aşağıdaki yapılandırmayı ekleyin:

{
  "imessage-query": {
    "command": "uv",
    "args": [
      "run",
      "--with",
      "fastmcp",
      "fastmcp",
      "run",
      "/path/to/repo/imessage-query-server.py"
    ]
  }
}

/path/to/repo yerine bu depoyu klonladığınız yolun tam yolunu yazın (örneğin, /Users/username/Projects/imessage-query-fastmcp-mcp-server)

🔒 Güvenlik Özellikleri

• iMessage veritabanına salt okunur erişim
• phonenumbers kütüphanesi kullanarak telefon numarası doğrulaması
• Eksik dosya algılaması ile güvenli ek dosya işleme
• Tarih aralığı doğrulaması
• Temiz JSON yanıtları için ilerleme çıktısı bastırılması

📚 Geliştirme Dokümantasyonu

Depo, geliştirme için dokümantasyon dosyaları içerir:

• dev_docs/imessagedb-documentation.txt: iMessage veritabanı yapısı ve imessagedb kütüphanesinin özellikleri hakkında kapsamlı dokümantasyon içerir.

Bu dokümantasyon, özellik geliştirme sırasında bağlam olarak hizmet eder ve geliştirmeye yardımcı olmak için LLM'ler ile kullanılabilir.

⚙️ Ortam Değişkenleri

Sunucu iMessage veritabanını otomatik olarak varsayılan macOS konumunda bulduğu için hiçbir ortam değişkeni gerekli değildir.