Skip to main content
Glama
Medium MCP

Medium MCP

by ycagraoglu

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ı

Related MCP server: Medium MCP Server

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.

Available Tools

4 tools
check_medium_sessionA

Check whether the dedicated Medium browser profile appears to be signed in.

Inputs: no named parameters.

get_medium_articleA

Read a Medium article using the locally persisted Medium browser session and return Markdown.

Inputs: url (required).

login_to_mediumA

Open Medium's sign-in page in a dedicated persistent Microsoft Edge profile. The user can complete Google sign-in manually in the visible browser window.

Inputs: no named parameters.

search_mediumA

Search Medium and return article titles, URLs, authors and excerpts.

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: checking session auth, logging in, fetching an article, and searching. No overlap or ambiguity between them.

    Naming Consistency4/5

    All names use snake_case and start with a verb (check, login, get, search). 'login_to_medium' is a slight deviation in structure but still follows a clear pattern.

    Tool Count5/5

    Four tools is well-scoped for a Medium integration focused on authentication, reading, and searching. Each tool serves a necessary function without redundancy.

    Completeness4/5

    The set covers the core read-only workflow: session management, login, search, and fetching articles. Minor gaps like logout or bookmark listing exist but are not essential for the apparent purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Google search queries and webpage content extraction through an MCP server deployed on Cloudflare Workers. Supports single and batch webpage content extraction with integrated OAuth authentication.
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to read and analyze Medium blog posts, including member-only content with login support, and search articles by author or keyword.
      11
      6 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Google Search using a logged-in browser profile, delivering personalized, ad-free results with advanced operators and pagination. It also fetches web pages as markdown through the same browser session.
      5
      33 PyPI
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients like Codex, Claude Code, and Cursor to connect to Microsoft Edge through automatic browser discovery and the official Chrome DevTools MCP server, preserving cookies, sessions, and extensions.
      11 npm
      MIT