writefreely-mcp-server

Servidor MCP que permite que agentes de IA publiquem e gerenciem conteúdo no Write.as e em instâncias WriteFreely auto-hospedadas.

GitHub
3

Documentação

writefreely-mcp-server

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

Um servidor MCP para WriteFreely que permite que agentes de IA publiquem e gerenciem conteúdo em instâncias WriteFreely (incluindo instâncias auto-hospedadas e Write.as).

Recursos

  • Publicar posts (anônimos ou autenticados)
  • Gerenciar coleções e posts
  • Navegar por feeds públicos
  • Suporte para Write.as e instâncias WriteFreely auto-hospedadas

Instalação

Instalando uv ou uvx

Se você não tem uv ou uvx instalados, pode instalá-los usando um dos seguintes 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

Após a instalação, uvx estará disponível como parte de uv. Veja a documentação do uv para mais detalhes.

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

Configuração

Configure por meio de variáveis de ambiente:

  • WRITEFREELY_BASE_URL - URL base (padrão: https://write.as)
  • WRITEFREELY_ACCESS_TOKEN - Token de acesso para autenticação
  • WRITEFREELY_DEFAULT_LANGUAGE - Idioma padrão (padrão: en)

Obtendo um Token de Acesso

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

Configuração do 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"
      }
    }
  }
}

Ferramentas Disponíveis

  • login() - Autenticar com nome de usuário/senha
  • publish_post() - Criar e publicar um novo post
  • edit_post() - Atualizar um post existente
  • delete_post() - Excluir um post
  • read_post() - Ler um post por ID
  • list_my_posts() - Listar todos os seus posts
  • list_my_collections() - Listar todas as suas coleções/blogs
  • browse_collection() - Navegar pelos posts em uma coleção
  • browse_public_feed() - Navegar pelo feed público

Licença

MIT

Links