writefreely-mcp-server

Servidor MCP que permite a agentes de IA publicar y gestionar contenido en Write.as e instancias autoalojadas de WriteFreely.

GitHub
3

Documentación

writefreely-mcp-server

Source Code Issues Python 3.10 | 3.11 | 3.12 PyPI MIT License PyPI - Downloads

Un servidor MCP para WriteFreely que permite a los agentes de IA publicar y gestionar contenido en instancias de WriteFreely (incluidas instancias autoalojadas y Write.as).

Características

  • Publicar publicaciones (anónimas o autenticadas)
  • Gestionar colecciones y publicaciones
  • Explorar fuentes públicas
  • Soporte para Write.as e instancias de WriteFreely autoalojadas

Instalación

Instalando uv o uvx

Si no tienes uv o uvx instalados, puedes instalarlos usando uno de los siguientes métodos:

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Usando Homebrew (macOS):

brew install uv

Usando pip:

pip install uv

Después de la instalación, uvx estará disponible como parte de uv. Consulta la documentación de uv para más detalles.

Usando uvx (recomendado)

uvx --from writefreely-mcp-server writefreely-mcp

Usando uv

uv tool install writefreely-mcp-server
writefreely-mcp

Usando pip

pip install writefreely-mcp-server

Configuración

Configura mediante variables de entorno:

  • WRITEFREELY_BASE_URL - URL base (predeterminado: https://write.as)
  • WRITEFREELY_ACCESS_TOKEN - Token de acceso para autenticación
  • WRITEFREELY_DEFAULT_LANGUAGE - Idioma predeterminado (predeterminado: en)

Obteniendo un Token de Acceso

curl -X POST https://write.as/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"alias": "your_username", "pass": "your_password"}'

Configuración del Cliente MCP

{
  "mcpServers": {
    "writefreely": {
      "command": "uvx",
      "args": ["--from", "writefreely-mcp-server", "writefreely-mcp"],
      "env": {
        "WRITEFREELY_BASE_URL": "https://write.as",
        "WRITEFREELY_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Herramientas Disponibles

  • login() - Autenticar con nombre de usuario/contraseña
  • publish_post() - Crear y publicar una nueva publicación
  • edit_post() - Actualizar una publicación existente
  • delete_post() - Eliminar una publicación
  • read_post() - Leer una publicación por ID
  • list_my_posts() - Listar todas tus publicaciones
  • list_my_collections() - Listar todas tus colecciones/blogs
  • browse_collection() - Explorar publicaciones en una colección
  • browse_public_feed() - Explorar la fuente pública

Licencia

MIT

Enlaces