esaio avatar

pplog

esaio/pplog-mcp-server

Connects Claude to pplog.net, a Japanese poem sharing service. You get three operations: fetch poems by ID, search with date filters and boolean logic (AND/OR/exclusion), and post new poems. Requires a PPLOG_ACCESS_TOKEN environment variable. The README recommends running it via Docker for the cleanest setup, though npx works too. Useful if you're building workflows around collaborative poetry or want an AI assistant that can read and publish to pplog directly. The server handles stdio transport and ships as both a container image and npm package.

tools
3
auth
Secret needed
transport
STDIO
env var
1
last updated
Oct 30, 2026

Tools

3 tools

Public tool metadata for what this MCP can expose to an agent.

get-poemポエムを ID で取得

ポエムを ID で取得

No parameter schema in public metadata yet.

search-poemsポエムを検索(日付絞り込み、AND/OR 検索、除外検索などに対応)

ポエムを検索(日付絞り込み、AND/OR 検索、除外検索などに対応)

No parameter schema in public metadata yet.

create-poem新しいポエムを投稿

新しいポエムを投稿

No parameter schema in public metadata yet.

Sponsors

Configuration

PPLOG_ACCESS_TOKEN*secret

Access token for pplog API authentication

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(推奨)
{
  "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

View the full README on GitHub

Details

Repository
github.com/esaio/pplog-mcp-server
Package
@esaio/pplog-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from esaio