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

Related MCP server: systemprompt-mcp-reddit

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:

python substack_mcp.py

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