pplog

io.github.esaioPublished by GitHub account esaiov0.5.1Updated Oct 30, 2026

Official MCP server for pplog - a poem sharing service

VerifiedSTDIODesktop onlyWeb Search & ScrapingCommunication & Collaboration

Overview

AI-generated overview

Official pplog MCP server that lets an AI assistant read, search and post short casual notes ("poems") on the pplog sharing service.

What you can do
  • Fetch a single poem by its ID
  • Search poems with advanced query syntax, including date filters, AND/OR and exclusion searches
  • Create a new poem, i.e. a casual short note rather than literary verse
When to use it
Use it when you want an assistant to browse or search pplog content, or to publish short notes to a pplog account directly from a chat.
Requirements
Runs locally over stdio, either via the npm package with npx (Node.js) or the Docker image. Requires a pplog access token supplied in the PPLOG_ACCESS_TOKEN environment variable, plus network access to the pplog API.
Before you install
The PPLOG_ACCESS_TOKEN secret is required and must be kept out of shared config files. Creating a poem publishes content publicly and hides your previous poem from other readers, so posting is not a private or reversible-looking action.

Installation

In SourceWeft

  1. Open pplog in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

pplog MCP Server

[License: MIT]

日本語 | English

pplog の公式 MCP(Model Context Protocol)サーバー(STDIO Transport 版)

概要

AI アシスタントとポエム共有サービス pplog をつなぐ MCP サーバーです。Model Context Protocol 経由で、AI アシスタントから pplog のポエムを読んだり、検索・投稿ができます。

使えるツール

  • get-poem - ポエムを ID で取得
  • search-poems - ポエムを検索（日付絞り込み、AND/OR 検索、除外検索などに対応）
  • create-poem - 新しいポエムを投稿

MCP クライアントの設定

MCP クライアントの設定ファイルに以下を追加します：

用意する環境変数

  • PPLOG_ACCESS_TOKEN: アクセストークン

Claude Desktop の例

claude_desktop_config.json への追加方法：

オプション 1: docker(推奨)
json
{  "mcpServers": {    "pplog": {      "command": "docker",      "args": [        "run",        "-i",        "--rm",        "-e",        "PPLOG_ACCESS_TOKEN",        "ghcr.io/esaio/pplog-mcp-server"      ],      "env": {        "PPLOG_ACCESS_TOKEN": "your_access_token"      }    }  }}
オプション 2: npx
json
{  "mcpServers": {    "pplog": {      "command": "/Users/your-username/.nodenv/shims/npx",      "args": ["@esaio/pplog-mcp-server"],      "env": {        "PPLOG_ACCESS_TOKEN": "your_access_token"      }    }  }}

注意: /path/to/your/node は which node で調べたパスに置き換えてください。

リンク

サポート

Made with ❤️ by the esa team

Source: README.md at commit 2e4ff3b

Tools

3

get-poem

Get Poem

Retrieves a poem from pplog by ID.

Parametersidrequired

search-poems

Search Poems

Searches for poems in pplog with advanced query syntax support.

Parameterspagekeyword

create-poem

Create Poem

Creates a pplog poem: a casual short note (not literary verse). Posting hides your previous poem from other readers.

Parameterscontentrequired

Version history

3
  1. v0.5.1LatestOct 30, 2026
  2. v0.5.0Oct 16, 2026
  3. v0.4.1Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts