Medium MCP

Kişisel Medium oturumunuz üzerinden Medium makalelerini okumak için hazırlanmış, yerel ve salt-okunur bir MCP sunucusudur.

Bu proje:

• MCP istemcileriyle stdio üzerinden çalışır.
• Ayrı bir React uygulaması veya tarayıcı eklentisi kullanmaz.
• Playwright ile projeye özel kalıcı bir Microsoft Edge profili açar.
• Medium hesabına Google ile manuel giriş yapılmasını destekler.
• Google kullanıcı adı, parola veya doğrulama kodlarını okumaz ve saklamaz.
• Oturumu .data/medium-profile klasöründe yerel olarak saklar.
• Makale içeriğini Markdown olarak MCP istemcisine döndürür.

Gereksinimler

• Node.js 20 veya üzeri
• Microsoft Edge
• Medium hesabı

Kurulum

git clone https://github.com/ycagraoglu/medium-mcp.git
cd medium-mcp
npm install
npm run build

Playwright, varsayılan olarak bilgisayarınızda kurulu Microsoft Edge'i msedge kanalıyla kullanır. Ayrı Chromium indirmek gerekmez.

İlk Medium girişi

npm run login

Açılan gerçek Edge penceresinde:

1. Continue with Google seçeneğine basın.
2. Google hesabınızla giriş işlemini kendiniz tamamlayın.
3. İki aşamalı doğrulama çıkarsa normal şekilde tamamlayın.
4. Medium ana sayfasında hesabınızın açıldığını gördükten sonra terminale dönün.
5. ENTER tuşuna basın.

Sistem Google girişini otomatikleştirmez. Yalnızca sizin manuel giriş yaptığınız Edge profilini kalıcı olarak tekrar kullanır.

Oturum şu klasörde saklanır:

.data/medium-profile

Bu klasör Git'e gönderilmez. İçinde tarayıcı çerezleri ve yerel oturum bilgileri bulunduğu için paylaşılmamalıdır. Hesap oturumunu sıfırlamak için Edge ve MCP süreçlerini kapattıktan sonra klasörü silebilirsiniz.

MCP istemcisi yapılandırması

Windows yollarında / kullanmak JSON kaçış sorunlarını önler:

{
  "mcpServers": {
    "medium-mcp": {
      "command": "node",
      "args": [
        "C:/Users/ycagr/Music/repos/medium-mcp/dist/index.js"
      ],
      "cwd": "C:/Users/ycagr/Music/repos/medium-mcp"
    }
  }
}

Önce npm run build çalıştırılmış olmalıdır.

MCP araçları

login_to_medium

Medium giriş sayfasını kalıcı Edge profilinde açar. Google ile giriş görünür tarayıcı penceresinde kullanıcı tarafından tamamlanır. İlk kurulum için terminaldeki npm run login komutu daha uygundur.

check_medium_session

Yerel tarayıcı profilindeki Medium oturumunun açık görünüp görünmediğini kontrol eder.

get_medium_article

Bir Medium URL'sini açar, makaleyi mevcut oturumla okur ve Markdown döndürür.

Örnek istek:

Bu Medium makalesini oku ve Türkçe özetle:
https://medium.com/...

search_medium

Medium üzerinde metin araması yapar ve sonuçların başlık, URL, yazar ve kısa açıklamalarını döndürür.

Ortam değişkenleri

Varsayılan Edge yerine Playwright Chromium kullanmak için:

$env:MEDIUM_BROWSER_CHANNEL="chromium"

Arka planda çalıştırmayı denemek için:

$env:MEDIUM_HEADLESS="true"

İlk Google girişi sırasında MEDIUM_HEADLESS kullanılmamalıdır. İlk oturum açıldıktan sonra headless çalışma denenebilir; Medium veya Google davranışı değişirse görünür Edge kullanmak daha güvenilirdir.

Güvenlik ve sınırlar

• Proje şifre toplamaz veya dış sunucuya göndermez.
• Google giriş formu doğrudan Google ve Edge arasında çalışır.
• Medium oturumu yalnızca yerel tarayıcı profilinde tutulur.
• .data/medium-profile klasörü kişisel ve hassas kabul edilmelidir.
• Yalnızca https://medium.com ve Medium alt alan adları kabul edilir.
• Medium arayüzü değişirse DOM seçicilerinin güncellenmesi gerekebilir.
• Erişim yetkisi olmayan üye içeriklerinin kilidini açmaz; yalnızca hesabınızın görüntüleyebildiği içeriği okur.