이 글 내용을 한글로 번역해줘: https://medium.com/@username/article-title

이 Medium 글을 요약해줘: https://towardsdatascience.com/some-article

이 글의 핵심 포인트 3가지를 정리해줘: [Medium URL]

이 기술 블로그에서 설명하는 개념을 초보자도 이해할 수 있게 설명해줘: [Medium URL]

@springrod 의 글 목록을 보여줘

@username 의 글 중에서 "AI agent" 관련 글을 찾아줘

Medium에서 "React hooks" 관련 글을 검색해줘

Medium에 로그인해줘
→ (브라우저에서 로그인 완료 후)
로그인 세션 저장해줘
→ 이제 멤버십 전용 글도 읽을 수 있어요!

stackademic.com 도메인 추가해줘
→ 이제 stackademic.com 글도 읽을 수 있어요!

도메인 추가해줘: stackademic.com

// ~/.medium-mcp/config.json
{
  "additionalDomains": ["stackademic.com", "blog.example.com"]
}

{
  "mcpServers": {
    "medium": {
      "command": "node",
      "args": ["/절대/경로/medium-mcp-server/dist/index.js"],
      "env": {
        "MEDIUM_ADDITIONAL_DOMAINS": "stackademic.com,another.com"
      }
    }
  }
}

git clone https://github.com/yoyojyv/medium-mcp-server.git
cd medium-mcp-server

npm install

npx playwright install chromium

npm run build

{
  "mcpServers": {
    "medium": {
      "command": "node",
      "args": ["/절대/경로/medium-mcp-server/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "medium": {
      "command": "node",
      "args": ["/절대/경로/medium-mcp-server/dist/index.js"]
    }
  }
}

# tools 목록 확인
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js

{
  "title": "글 제목",
  "author": "작성자",
  "publishedAt": "2025-12-15T00:00:00Z",
  "content": "# 글 제목\n\n본문 내용 (Markdown)...",
  "excerpt": "글 요약",
  "url": "https://medium.com/..."
}

이 Medium 글을 읽고 요약해줘: https://medium.com/@username/article-title-123abc

Medium에 로그인해줘

로그인 세션을 저장해줘

{
  "loggedIn": true,
  "storagePath": "/Users/username/.medium-mcp/auth.json",
  "message": "You are logged in. Member-only content should be accessible."
}

Medium에서 로그아웃해줘

stackademic.com 도메인 추가해줘

{
  "defaultDomains": ["medium.com", "towardsdatascience.com", ...],
  "customDomains": ["stackademic.com"],
  "allDomains": ["medium.com", ..., "stackademic.com"],
  "configPath": "/Users/username/.medium-mcp/config.json"
}

지원되는 도메인 목록 보여줘

stackademic.com 도메인 제거해줘

{
  "username": "springrod",
  "articleCount": 10,
  "articles": [
    {
      "title": "글 제목",
      "url": "https://medium.com/@springrod/...",
      "publishedAt": "Mon, 22 Dec 2025 08:25:33 GMT",
      "categories": ["genai", "java", "ai-agent"],
      "content": "전체 HTML 콘텐츠 (RSS 모드에서만)"
    }
  ],
  "source": "rss",
  "hasMore": true
}

@springrod 의 글 목록을 보여줘

@username 의 최근 글 20개를 스크래핑으로 가져와줘

{
  "query": "AI agent java",
  "resultCount": 5,
  "results": [
    {
      "title": "글 제목",
      "url": "https://medium.com/...",
      "author": "작성자",
      "excerpt": "글 요약"
    }
  ],
  "hasMore": true
}

Medium에서 "React hooks" 관련 글을 검색해줘

{
  "username": "springrod",
  "keyword": "agent",
  "matchCount": 8,
  "articles": [...],
  "note": "Search is limited to author's ~10 most recent articles from RSS feed"
}

@springrod 의 글 중에서 "agent" 관련 글을 찾아줘

# 예시 대화
사용자: Medium에 로그인해줘
Claude: 브라우저가 열렸습니다. 로그인을 완료한 후 알려주세요.

사용자: 로그인 완료했어. 세션 저장해줘
Claude: 로그인 세션이 저장되었습니다.

사용자: 이 글 읽어줘: https://medium.com/membership-only-article
Claude: (멤버십 전용 글 내용 표시)

npm run dev

npm run build

src/
├── index.ts              # 진입점
├── server.ts             # MCP 서버 설정
├── config/
│   ├── constants.ts      # 도메인 목록, 타임아웃 설정
│   └── settings.ts       # 설정 파일 관리
├── tools/
│   ├── read-article.ts   # read_article Tool
│   ├── auth.ts           # 로그인 관련 Tools
│   ├── domains.ts        # 도메인 관리 Tools
│   ├── author-articles.ts # list_author_articles Tool
│   └── search.ts         # search_articles, search_author_articles Tools
├── services/
│   ├── article-extractor.ts  # Playwright + Readability
│   ├── rss-feed.ts           # RSS 피드 파싱
│   ├── author-scraper.ts     # Author 페이지 스크래핑
│   └── search-scraper.ts     # 검색 페이지 스크래핑
├── types/
│   ├── article.ts            # Article 타입
│   ├── author-article.ts     # AuthorArticle 타입
│   └── search-result.ts      # SearchResult 타입
└── utils/
    ├── errors.ts         # 에러 클래스
    ├── logger.ts         # 로깅
    └── response.ts       # 응답 포맷