mcpField
P
pplog

pplog

Local
github.com/esaioSocial Media0Updated 2w ago
Repository

About pplog

pplog MCP Server connects AI assistants to pplog, a poem-sharing service. It lets them retrieve poems by ID, search with filters, and publish new poems.

Key features

  1. 01Retrieve poems by ID
  2. 02Search poems with filters
  3. 03Publish new poems

Use cases

  1. 01Fetch a poem using its ID
  2. 02Search poems by date or query
  3. 03Exclude terms from poem searches
  4. 04Publish a poem through an AI assistant

MCP support

Exposes pplog poem retrieval, search, and creation tools to MCP clients over STDIO. An access token is supplied through the PPLOG_ACCESS_TOKEN environment variable.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "esaio-pplog": {
      "command": "npx",
      "args": [
        "-y",
        "@esaio/pplog-mcp-server"
      ],
      "env": {
        "PPLOG_ACCESS_TOKEN": "<PPLOG_ACCESS_TOKEN>"
      }
    }
  }
}
Run commandnpx -y @esaio/pplog-mcp-server
Environment variables to set
PPLOG_ACCESS_TOKENSecretAccess token for pplog API authentication

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@esaio/pplog-mcp-server0.5.0
ocighcr.io/esaio/pplog-mcp-server:0.5.0

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
idstringYesPoem ID

Details

From the project 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
{
  "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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.