서브스택 MCP

Claude 및 기타 AI 어시스턴트와 Substack API를 통합하기 위한 MCP(Model Context Protocol) 서버입니다.

개요

이 프로젝트는 Claude와 같은 AI 비서가 표준화된 인터페이스를 통해 Substack 뉴스레터, 게시물 및 작성자와 상호 작용할 수 있도록 하는 MCP(Model Context Protocol) 서버를 구현합니다. Substack API 라이브러리를 활용하고 MCP를 통해 해당 기능을 제공합니다.

이 MCP 서버를 사용하면 Claude는 다음을 수행할 수 있습니다.

뉴스레터 게시물, 팟캐스트 및 추천 검색
게시물 콘텐츠 및 메타데이터 가져오기
뉴스레터 내 게시물 검색
사용자 프로필 정보 및 구독 받기

Related MCP server: systemprompt-mcp-reddit

설치

필수 조건

Python 3.10 이상
데스크톱용 Claude (테스트용)

설정

이 저장소를 복제하세요:
지엑스피1
uv 사용하여 가상 환경을 설정합니다.
curl -LsSf https://astral.sh/uv/install.sh | sh # Install uv if not already installed uv init . uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
종속성 설치:
uv add "mcp[cli]" substack-api

용법

서버 실행

MCP 서버를 실행합니다.

python substack_mcp.py

데스크톱용 Claude 구성

Claude for Desktop의 구성 파일을 엽니다.
- macOS/Linux : ~/Library/Application Support/Claude/claude_desktop_config.json
- 윈도우 : %APPDATA%\Claude\claude_desktop_config.json
서버 구성을 추가하세요:
{ "mcpServers": { "substack": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/substack-mcp", "run", "substack_mcp.py" ] } } }
데스크톱에서 Claude를 다시 시작합니다.

예제 쿼리

구성이 완료되면 Claude에게 다음과 같은 질문을 할 수 있습니다.

" https://stratechery.com/ 의 최근 게시물을 보여주세요"
"이 게시물의 내용은 무엇입니까: https://stratechery.com/2023/the-ai-unbundling/ "
" https://stratechery.com/ 에서 'AI'를 검색하세요"
" https://stratechery.com/ 의 저자는 누구입니까?"

사용 가능한 도구

서버는 다음과 같은 MCP 도구를 제공합니다.

도구	설명
`get_newsletter_posts`	Substack 뉴스레터에서 최근 게시물을 검색합니다.
`get_post_content`	특정 Substack 게시물의 전체 내용을 가져옵니다.
`search_newsletter`	뉴스레터 내 게시물 검색
`get_author_info`	Substack 작성자에 대한 정보를 가져옵니다.
`get_newsletter_recommendations`	Substack 출판물에 대한 추천 뉴스레터를 받습니다.
`get_newsletter_authors`	Substack 뉴스레터 작성자를 찾습니다.

프로젝트 구조

substack_mcp.py - 주요 MCP 서버 구현
examples/ - 예제 쿼리 및 응답
docker/ - 컨테이너화된 배포를 위한 Docker 구성

개발

이 프로젝트에 기여하려면:

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

문제 해결

문제가 발생하는 경우:

Claude의 로그에서 오류를 확인하세요.
# macOS/Linux tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log
서버가 오류 없이 빌드되고 실행되는지 확인하세요.
python substack_mcp.py
claude_desktop_config.json 파일의 경로와 구문이 올바른지 확인하세요.
Claude for Desktop을 완전히 다시 시작해 보세요.