서브스택 MCP

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

개요

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

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

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

설치

필수 조건

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

설정

1. 이 저장소를 복제하세요:지엑스피1
2. 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
3. 종속성 설치:
   uv add "mcp[cli]" substack-api

용법

서버 실행

MCP 서버를 실행합니다.

데스크톱용 Claude 구성

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

예제 쿼리

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

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

사용 가능한 도구

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

프로젝트 구조

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

개발

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

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

문제 해결

문제가 발생하는 경우:

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

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

• Substack API - Substack 상호 작용을 위한 기본 라이브러리
• 모델 컨텍스트 프로토콜 - 표준화된 LLM 통합을 위한 Anthropic 프로토콜