puremd MCP Sunucusu

“puremd” MCP Sunucusu ne yapar?

puremd MCP (Model Context Protocol) Sunucusu, AI asistanları ve ajanlarını web içeriğiyle buluşturan, engel kaldırıcı, kazıyıcı ve arama köprüsü olarak çalışan güçlü bir araçtır. pure.md platformundan yararlanarak, betiklerin, API’ların, uygulamaların ve ajanların herhangi bir URL’nin başına pure.md/ ekleyerek web sayfalarına markdown formatında erişmesini sağlar. Bu yaklaşım, bot tespitini aşar, JavaScript ağırlıklı tek sayfa uygulamalarını işler ve çok çeşitli formatları (HTML, PDF, görseller) markdown’a dönüştürür. Küresel olarak önbelleğe alınan yanıtlar, aynı kaynaklara tekrar erişimi verimli hale getirir ve kaynak sunucu üzerindeki yükü azaltır. puremd-mcp sunucusu, MCP istemcilerine (Cursor, Windsurf ve Claude Desktop gibi) bu özelliklerin nasıl kullanılacağını öğretir, böylece içerik engelini kaldırır ve gelişmiş web aramasını doğrudan AI geliştirme iş akışına entegre eder.

İstem Listesi

Depoda veya belgede açıkça tanımlanmış herhangi bir istem şablonuna yer verilmemiştir.

Kaynak Listesi

Depoda veya belgede (MCP tarafından tanımlandığı şekliyle) herhangi bir özel kaynağa yer verilmemiştir.

Araç Listesi

• unblock-url
  Web sayfalarından engellenmeden markdown çıkarır, böylece AI istemcilerinin anti-bot önlemleri olan sitelerden bile okunabilir içerik alabilmesini sağlar.
• search-web
  Belirli bir sorgu için webde arama yapar ve sonuçları tek bir markdown belgede birleştirerek ajanlar ve kullanıcılar için özetlenmiş arama içgörüleri sunar.

Bu MCP Sunucusunun Kullanım Senaryoları

• Web Kazıma İçin Bot Tespitini Atlatma
  Ajanların ve LLM’lerin, genellikle otomatik betikleri engelleyen sitelerden içerik almasını sağlar; pure.md altyapısı sayesinde tespit edilmeden erişim sağlar.
• Web İçeriğini Markdown’a Dönüştürme
  Çeşitli web kaynaklarını (HTML, PDF, görseller) markdown formatına dönüştürerek aşağı akış LLM işlemleri ve ajan iş akışları için standart giriş sunar.
• Web Arama Entegrasyonu
  AI asistanlarına web araması yapma ve sonuçları markdown olarak alma imkanı verir; araştırma, özetleme ve bağlam oluşturma için gereklidir.
• Küresel İçerik Önbellekleme
  Daha önce erişilen kaynaklar için pure.md’nin CDN-benzeri önbelleklemesinden yararlanarak sunucu yükünü azaltır ve tekrar eden sorgularda hızlı erişim sağlar.
• Sorunsuz LLM Bağlam Zenginleştirme
  Geliştiricilere, LLM bağlam pencerelerini alakalı ve güncel web bilgisiyle otomatik olarak zenginleştirmenin bir yolunu sunar ve bilgi tabanlı AI uygulamalarının performansını artırır.

Kurulum Nasıl Yapılır

Windsurf

1. Node.js ve npm’nin kurulu olduğundan emin olun.
2. pure.md üzerinden bir PUREMD API anahtarı oluşturun (daha yüksek sınırlar için isteğe bağlı).
3. ./codeium/windsurf/model_config.json dosyasını düzenleyin.
4. Aşağıdaki MCP sunucu girişini ekleyin:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

5. Değişikliklerin geçerli olması için Windsurf’u kaydedin ve yeniden başlatın.

Claude

1. Node.js ve npm’nin kurulu olduğundan emin olun.
2. pure.md üzerinden bir PUREMD API anahtarı edinin.
3. ~/Library/Application Support/Claude/claude_desktop_config.json dosyasını düzenleyin.
4. Aşağıdaki yapılandırmayı ekleyin:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

5. Kaydedin ve Claude Desktop’u yeniden başlatın.

Cursor

1. Node.js ve npm’yi yükleyin.
2. pure.md üzerinden kayıt olun ve bir PUREMD API anahtarı oluşturun.
3. ~/.cursor/mcp.json dosyasını düzenleyin.
4. Aşağıdaki MCP sunucu yapılandırmasını ekleyin:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

5. Kaydedin ve Cursor’u yeniden başlatın.

Cline

Depoda veya belgede Cline’a özel herhangi bir talimat verilmemiştir.

API Anahtarlarının Güvenli Saklanması (Ortam Değişkenleri)

API anahtarlarınızı MCP sunucu yapılandırmanızda env alanını kullanarak güvenli şekilde saklayın:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

Bu MCP Nasıl Akışlarda Kullanılır

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, önce MCP bileşenini akışınıza ekleyin ve AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırması bölümünde MCP sunucu detaylarınızı şu JSON formatında girin:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırıldıktan sonra, AI ajanınız bu MCP’yi tüm işlev ve yetenekleriyle bir araç olarak kullanabilir. “MCP-name” ifadesini kendi MCP sunucunuzun adıyla (ör. “github-mcp”, “weather-api” vb.) ve URL’yi de kendi MCP sunucu adresinizle değiştirmeniz gerektiğini unutmayın.

Genel Bakış

Mevcut belgeler ışığında, puremd-mcp web engel kaldırma ve arama için odaklanmış ve pratik bir MCP sunucusudur. Ancak istem şablonları ve kaynak tanımları eksiktir, Roots veya Örnekleme desteğinden bahsedilmemiştir. Genel web erişimi ve arama için, sadeliği ve anında faydasıyla sağlam bir puan alır.

MCP Puanı