Medium MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Medium MCP Search Medium for 'MCP servers'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-profileklasö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 buildPlaywright, 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 loginAçılan gerçek Edge penceresinde:
Continue with Googleseçeneğine basın.Google hesabınızla giriş işlemini kendiniz tamamlayın.
İki aşamalı doğrulama çıkarsa normal şekilde tamamlayın.
Medium ana sayfasında hesabınızın açıldığını gördükten sonra terminale dönün.
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-profileBu 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-profileklasörü kişisel ve hassas kabul edilmelidir.Yalnızca
https://medium.comve 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 toolscheck_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
Scored across 4 tools
Each tool has a clearly distinct purpose: checking session auth, logging in, fetching an article, and searching. No overlap or ambiguity between them.
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.
Four tools is well-scoped for a Medium integration focused on authentication, reading, and searching. Each tool serves a necessary function without redundancy.
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
Related MCP Connectors
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
Read-only MCP server for Aleksei Aleinikov's Cloud/AI articles, CV profile & browser tools.
MCP server (stdio): fetch web pages as clean readable markdown via the AgentForge API
Read web pages as markdown, search the web, list a site's URLs and run a real Chrome.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables 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-
- AlicenseAqualityDmaintenanceEnables AI assistants to read and analyze Medium blog posts, including member-only content with login support, and search articles by author or keyword.116 npmMIT
- AlicenseAqualityCmaintenanceMCP 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.533 PyPIMIT
- AlicenseNot gradedqualityBmaintenanceEnables 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 npmMIT