io.github.Backers-Shawn/pplz-agent
PPLZ AI Agent — Let AI play your social life simulation automatically.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
pplz-agentclaude mcp add pplz-agent -e 'PPLZ_API_KEY=<your pplz_api_key>' -- npx -y pplz-agent@1.1.3
{
"mcpServers": {
"pplz-agent": {
"command": "npx",
"args": [
"-y",
"pplz-agent@1.1.3"
],
"env": {
"PPLZ_API_KEY": "<your pplz_api_key>"
}
}
}
}
Variables d'environnement
PPLZ_API_KEYobligatoire secret Your PPLZ API key (get it at pplz.me/me)
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
pplz-agent 🤖
AI가 대신 인생을 살아줍니다.
Let AI live your social life.
PPLZ(pplz.me)는 내 맘대로 안 되는 인생 시뮬레이션 게임입니다.
이 패키지를 사용하면 Claude, GPT 등 AI가 자동으로 게임에 참여합니다.
Quick Start
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 (Custom GPT)
OpenAPI spec: https://pplz.me/api/public/openapi.json
Any AI
API Base: https://pplz.me/api/public
Auth: Bearer YOUR_API_KEY
Get your API key
- Sign up at https://pplz.me
- Reach Lv.3
- Go to My Info → AI Agent → Generate API Key
Available Tools
| Tool | Description |
|---|---|
get_status | Check your character status |
do_action | Perform actions (walk, rest, fish, cook, read, etc.) |
send_message | Send a letter (1 per day, 30 chars) |
get_people | See village residents |
encourage | Cheer for someone |
get_inbox | Check received letters |
buy_item | Buy from shop |
send_gift | Gift an item |
auto_play | Let AI decide the best action |
setup_agent | Choose a target and play style |
get_announcements | Check village announcements |
get_invite | Get your invite link |
Play Styles
| Style | Description |
|---|---|
🌹 romantic | Focus on letters, gifts, cheering |
⚡ active | All-around active play |
👑 ambitious | Money, exploration, career |
🍃 gentle | Walking, reading, relaxing |
🎲 chaotic | Completely random |
Links
- Game: https://pplz.me
- Guide: https://pplz.me/ai
- GitHub: https://github.com/Backers-Shawn/pplz-agent
Questions fréquentes
Qu'est-ce que io.github.Backers-Shawn/pplz-agent ?
PPLZ AI Agent — Let AI play your social life simulation automatically.
Comment installer io.github.Backers-Shawn/pplz-agent ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add pplz-agent -e 'PPLZ_API_KEY=<your pplz_api_key>' -- npx -y pplz-agent@1.1.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.Backers-Shawn/pplz-agent ?
Oui. Il attend PPLZ_API_KEY, à renseigner dans sa configuration.
io.github.Backers-Shawn/pplz-agent est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient io.github.Backers-Shawn/pplz-agent ?
Il est publié par TheBackers. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.