Subpila MCP

Un servidor MCP (Protocolo de contexto de modelo) para la integración de API de Substack con Claude y otros asistentes de IA.

Descripción general

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA como Claude interactuar con los boletines, publicaciones y autores de Substack mediante una interfaz estandarizada. Aprovecha la biblioteca de API de Substack y pone su funcionalidad a disposición a través de MCP.

Con este servidor MCP, Claude puede:

• Recuperar publicaciones de boletines, podcasts y recomendaciones
• Obtener contenido y metadatos de la publicación
• Buscar publicaciones dentro de los boletines
• Obtener información del perfil de usuario y suscripciones

Instalación

Prerrequisitos

• Python 3.10 o superior
• Claude para escritorio (para pruebas)

Configuración

1. Clonar este repositorio:
   git clone https://github.com/Greg-Swiftomatic/substack-mcp.git cd substack-mcp
2. Configurar un entorno virtual usando 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. Instalar dependencias:
   uv add "mcp[cli]" substack-api

Uso

Ejecución del servidor

Ejecute el servidor MCP:

Configuración de Claude para escritorio

1. Abra el archivo de configuración de Claude for Desktop:
   • macOS/Linux : ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas : %APPDATA%\Claude\claude_desktop_config.json
2. Añade la configuración de tu servidor:
   { "mcpServers": { "substack": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/substack-mcp", "run", "substack_mcp.py" ] } } }
3. Reinicie Claude para escritorio.

Consultas de ejemplo

Una vez configurado, puedes hacerle preguntas a Claude como:

• Muéstrame publicaciones recientes de https://stratechery.com/
• ¿Cuál es el contenido de esta publicación? https://stratechery.com/2023/the-ai-unbundling/
• Busca "IA" en https://stratechery.com/
• "¿Quiénes son los autores de https://stratechery.com/ ?

Herramientas disponibles

El servidor proporciona las siguientes herramientas MCP:

Estructura del proyecto

• substack_mcp.py : la implementación principal del servidor MCP
• examples/ - Ejemplos de consultas y respuestas
• docker/ - Configuración de Docker para implementación en contenedores

Desarrollo

Para contribuir a este proyecto:

1. Bifurcar el repositorio
2. Crear una rama de características ( git checkout -b feature/amazing-feature )
3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )
4. Empujar a la rama ( git push origin feature/amazing-feature )
5. Abrir una solicitud de extracción

Solución de problemas

Si encuentra problemas:

1. Revise los registros de Claude para ver si hay errores:
   # macOS/Linux tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log
2. Verifique que su servidor se compile y ejecute sin errores:
   python substack_mcp.py
3. Asegúrese de que su archivo claude_desktop_config.json tenga las rutas y la sintaxis correctas.
4. Intente reiniciar Claude for Desktop por completo.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

• API de Substack : la biblioteca subyacente para las interacciones de Substack
• Protocolo de contexto de modelo : protocolo de Anthropic para integraciones LLM estandarizadas