Official Substack MCP Server

Herramienta de contexto de escritor para Claude

Implementación del Protocolo de Contexto de Modelo (MCP) de código abierto que conecta a Claude con su escritura en Substack y Medium.

¿Qué es esto?

Writer Context Tool es un servidor MCP que permite a Claude acceder y analizar tus textos desde plataformas como Substack y Medium. Con esta herramienta, Claude puede comprender el contexto de tu contenido publicado, brindándote asistencia más personalizada con tu escritura.

Características

• 🔍Recupera y almacena en caché permanentemente tus publicaciones de blog de Substack y Medium
• 🔎 Utiliza incrustaciones para encontrar los ensayos más relevantes según tus consultas
• 📚 Pone a disposición ensayos individuales como recursos separados para Claude
• 🧠 Realiza búsquedas semánticas en tus escritos
• ⚡ Precarga todo el contenido y genera incrustaciones al inicio

Cómo funciona

La herramienta se conecta a tus blogs de Substack/Medium mediante sus feeds RSS, recupera tus publicaciones y las almacena en caché local de forma permanente. Además, genera incrustaciones para cada publicación, lo que permite la búsqueda semántica para encontrar los ensayos más relevantes según tus consultas.

Cuando le preguntas a Claude sobre tu escritura, puedes usar estos recursos de ensayos individuales para brindar información o ayudarte a desarrollar nuevas ideas basadas en tu contenido existente.

Instrucciones de configuración (paso a paso)

Prerrequisitos

• Python 3.10 o superior
• Claude Desktop (última versión)
• Una cuenta de Substack o Medium con contenido publicado

1. Clonar este repositorio

2. Configurar el entorno de Python

Uso de uv (recomendado):

O usando pip estándar:

3. Configura tus blogs

1. Copie el archivo de configuración de ejemplo:
   cp config.example.json config.json
2. Edite config.json con las URL de Substack/Medium:
   { "platforms": [ { "type": "substack", "url": "https://yourusername.substack.com", "name": "My Substack Blog" }, { "type": "medium", "url": "https://medium.com/@yourusername", "name": "My Medium Blog" } ], "max_posts": 100, "cache_duration_minutes": 10080, "similar_posts_count": 10 }
   • max_posts : Número máximo de publicaciones a obtener de cada plataforma (predeterminado: 100)
   • cache_duration_minutes : Cuánto tiempo se debe almacenar en caché el contenido antes de actualizarlo (valor predeterminado: 1 semana o 10080 minutos)
   • similar_posts_count : Número de publicaciones más relevantes que se mostrarán al realizar una búsqueda (predeterminado: 10)

4. Conéctate con Claude Desktop

1. Cree el directorio de configuración de Claude Desktop:
   # On macOS mkdir -p ~/Library/Application\ Support/Claude/
2. Crear el archivo de configuración:
   # Get the absolute path to your uv command UV_PATH=$(which uv) # Create the configuration cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << EOF { "mcpServers": { "writer-tool": { "command": "${UV_PATH}", "args": [ "--directory", "$(pwd)", "run", "writer_tool.py" ] } } } EOF

   Nota: Si experimenta problemas con el comando uv , puede utilizar la alternativa de script de shell incluida:

   1. Haga que el script sea ejecutable: chmod +x run_writer_tool.sh
   2. Actualice la configuración de Claude Desktop para usar el script:

   { "mcpServers": { "writer-tool": { "command": "/absolute/path/to/run_writer_tool.sh", "args": [] } } }

3. Reiniciar Claude Desktop

Usando la herramienta con Claude

Una vez configurado, verás ensayos individuales disponibles como recursos en Claude Desktop. Puedes:

1. Busca en tus escritos : pídele a Claude que encuentre contenido relevante
   • Encuentra ensayos donde abordo [tema específico]
   • "¿Qué he escrito sobre [tema]?"
2. Referenciar ensayos específicos : acceda a ensayos individuales haciendo clic en ellos cuando aparezcan en los resultados de búsqueda
   • "Muéstrame el texto completo de [título del ensayo]"
3. Actualizar contenido : fuerza una actualización de tu contenido
   • "Actualizar mi contenido escrito"

Herramientas y recursos disponibles

La herramienta de contexto del escritor proporciona:

1. Recursos para ensayos individuales : cada uno de sus ensayos se convierte en un recurso seleccionable
2. search_writing : una herramienta de búsqueda semántica que encuentra los ensayos más relevantes mediante incrustaciones
3. refresh_content : Actualiza y recupera su contenido desde todas las plataformas configuradas

Cómo funciona el almacenamiento en caché

La herramienta implementa almacenamiento en caché permanente con estas características:

1. Almacenamiento en caché de disco : todo el contenido se almacena en el disco, por lo que persiste entre sesiones.
2. Incrustaciones : cada ensayo se convierte en incrustaciones para la búsqueda semántica.
3. Actualización selectiva : la herramienta solo actualiza el contenido cuando es necesario según la configuración de caché
4. Precarga : todo el contenido se actualiza automáticamente y las incrustaciones se generan al inicio

Solución de problemas

Si encuentra problemas:

1. La herramienta no aparece en Claude Desktop:
   • Comprueba que tu archivo de configuración de Claude Desktop sea correcto
   • Verifique que todas las rutas en la configuración sean absolutas
   • Asegúrese de que su entorno Python tenga todos los paquetes necesarios
   • Reiniciar Claude Desktop
2. No aparece ningún contenido:
   • Verifique las URL de Substack/Medium en config.json
   • Intente utilizar la herramienta "refresh_content"
   • Comprueba que tus blogs sean públicos y tengan entradas publicadas
3. Error con el comando uv:
   • Intente utilizar el enfoque del script de shell en su lugar
   • Verifique que el comando uv esté instalado y en su PATH
4. Problemas de incrustación:
   • Si ve errores sobre el modelo de incrustación, asegúrese de tener suficiente espacio en disco
   • Considere volver a ejecutar con una nueva instalación si las incrustaciones no funcionan correctamente

Licencia

Este proyecto está disponible bajo la licencia MIT.