pplz-agent

本地服务

github.com/TheBackers游戏娱乐028 周前更新

代码仓库

关于 pplz-agent

pplz-agent 是用于 PPLZ 人生模拟游戏的 MCP 服务，让 Claude、GPT 等 AI 自动参与游戏。它提供查看角色与村民、执行日常行动和社交互动等工具，也支持设定目标与玩法风格。

主要功能

01查看角色状态和村民
02执行移动、休息、钓鱼等行动
03发送信件、鼓励和赠送物品
04查看收件箱与村庄公告
05设置目标和玩法风格

适用场景

01让 AI 自动参与 PPLZ 游戏
02查看角色状态并安排游戏行动
03与村民通信或赠送物品
04按指定风格自动游玩

MCP 相关

它作为 MCP 服务，为客户端提供 PPLZ 游戏工具，包括角色状态、行动、信件、物品赠送和自动游玩。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "backers-shawn-pplz-agent": {
      "command": "npx",
      "args": [
        "-y",
        "pplz-agent"
      ],
      "env": {
        "PPLZ_API_KEY": "<PPLZ_API_KEY>"
      }
    }
  }
}

启动命令npx -y pplz-agent

需要配置的环境变量

PPLZ_API_KEY密钥Your PPLZ API key (get it at pplz.me/me)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmpplz-agent1.1.3stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

pplz-agent 🤖

让 AI 替你体验人生。
让 AI 替你经营社交生活。

PPLZ（pplz.me）是一款事与愿违的人生模拟游戏。
使用此软件包后，Claude、GPT 等 AI 会自动参与游戏。

快速开始

Claude（MCP）

claude mcp add pplz -- npx pplz-agent --key=YOUR_API_KEY

Claude Desktop

~/.claude/claude_desktop_config.json：

{
  "mcpServers": {
    "pplz": {
      "command": "npx",
      "args": ["pplz-agent", "--key=YOUR_API_KEY"]
    }
  }
}

GPT（自定义 GPT）

OpenAPI 规范：https://pplz.me/api/public/openapi.json

任意 AI

API Base: https://pplz.me/api/public
Auth: Bearer YOUR_API_KEY

获取 API 密钥

在 https://pplz.me 注册
升至 Lv.3
前往 我的信息 → AI Agent → 生成 API 密钥

可用工具

工具	说明
`get_status`	查看角色状态
`do_action`	执行行动（散步、休息、钓鱼、烹饪、阅读等）
`send_message`	发送信件（每天 1 封，30 个字符）
`get_people`	查看村民
`encourage`	为某人加油
`get_inbox`	查看收到的信件
`buy_item`	从商店购买物品
`send_gift`	赠送物品
`auto_play`	让 AI 决定最佳行动
`setup_agent`	选择目标和游玩风格
`get_announcements`	查看村庄公告
`get_invite`	获取邀请链接

游玩风格

风格	说明
🌹 `romantic`	专注于信件、礼物和加油
⚡ `active`	全面积极地游玩
👑 `ambitious`	金钱、探索和事业
🍃 `gentle`	散步、阅读和放松
🎲 `chaotic`	完全随机