Lolipop MCP Server

Lolipop MCP 服务

日本語版 README はこちら / 日文 README

Lolipop Rental Server 的官方远程 Model Context Protocol (MCP) 服务。Lolipop Rental Server 是由 GMO Pepabo, Inc. 运营的共享 Web 托管服务。

通过与 AI 助手进行自然语言对话，即可管理域名、子域名、免费 SSL 证书和 WordPress 安装。

端点

https://lolipop.jp/api/v1/mcp

传输方式：Streamable HTTP。身份验证：通过 Authorization: Bearer 标头使用个人访问令牌（PAT）。

功能

• 域名管理 — 添加、列出、更新（公共文件夹）和移除自定义域名
• 子域名管理 — 添加、列出和移除子域名
• SSL — 列出免费 SSL 证书并申请签发（Let's Encrypt）
• WordPress — 列出安装项并运行一键安装
• 账户信息 — 获取已验证 API 密钥对应的账户信息（套餐、服务、速率限制）

定价：MCP 服务免费。 需要有效的 Lolipop Rental Server 合约。

身份验证

Lolipop MCP 服务使用**个人访问令牌（PAT）**进行身份验证。PAT 在 Lolipop 用户面板中签发。

1. 登录 Lolipop 用户面板 并签发 API 密钥（PAT）。复制令牌（lp_pat_...）。
2. 在 MCP 客户端中注册端点 URL，并添加 Authorization: Bearer <PAT> 标头（请参阅下方的快速开始）。

签发时可选择权限范围（domains:read / domains:write / ssl:read / ssl:write / wordpress:read / wordpress:write）。超出令牌权限范围的请求会返回 403 insufficient_scope。

注意： claude.ai（Web 应用的自定义连接器）目前需要 OAuth，且无法传递静态 Authorization 标头，因此暂不支持。请使用支持自定义标头的客户端（Claude Code、Cursor、Gemini CLI、OpenAI Codex），或使用下方的 mcp-remote stdio 桥接。

快速开始

请勿将 PAT 保存到已提交的文件或 Shell 历史记录中。 请将其存储在环境变量中（例如 LOLIPOP_PAT）并引用该变量，而不是将原始令牌粘贴到配置文件或命令行中。以下示例使用 ${LOLIPOP_PAT}。

export LOLIPOP_PAT="lp_pat_..."   # your issued token

Claude Code

claude mcp add --transport http lolipop https://lolipop.jp/api/v1/mcp \
  --header "Authorization: Bearer ${LOLIPOP_PAT}"

Claude Code MCP 文档

Cursor

添加到 .cursor/mcp.json。Cursor 会展开 ${env:VAR} 引用，因此原始令牌会保留在环境变量中，而不会写入文件：

{
  "mcpServers": {
    "lolipop": {
      "url": "https://lolipop.jp/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LOLIPOP_PAT}"
      }
    }
  }
}

Gemini CLI

添加到 ~/.gemini/settings.json。Gemini CLI 会从环境变量中展开 $VAR / ${VAR} 引用：

{
  "mcpServers": {
    "lolipop": {
      "httpUrl": "https://lolipop.jp/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${LOLIPOP_PAT}"
      }
    }
  }
}

详情请参阅 Gemini CLI MCP 服务文档。

OpenAI Codex CLI

Codex 支持远程 MCP 服务，并可通过 bearer_token_env_var 从环境变量中读取令牌。请按照 Codex MCP 文档配置 https://lolipop.jp/api/v1/mcp：

[mcp_servers.lolipop]
url = "https://lolipop.jp/api/v1/mcp"
bearer_token_env_var = "LOLIPOP_PAT"

本地 stdio 桥接（适用于不支持自定义标头的客户端）

使用 mcp-remote 将仅支持 stdio 的客户端桥接到远程端点。通过环境变量引用令牌，避免令牌出现在配置文件中：

{
  "mcpServers": {
    "lolipop": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://lolipop.jp/api/v1/mcp",
        "--header", "Authorization: Bearer ${LOLIPOP_PAT}"
      ]
    }
  }
}

文档

• 官方 MCP 服务指南（日文）
• 公共 API 参考（日文）

要求

• 一个使用受支持套餐的 Lolipop Rental Server 账户
• 从用户面板签发的个人访问令牌（PAT）
• 支持自定义请求标头的 MCP 兼容客户端（Claude Code、Cursor、Gemini CLI、OpenAI Codex CLI 等）

支持

• 服务相关咨询：Lolipop 支持
• 此代码库相关问题：请提交 GitHub Issue

许可证

MIT