Skip to main content
Glama
jaivedpereira

Hermit Purple MCP Server

🌿 HERMIT PURPLE

O Stand da IA

"O Stand que busca e adivinha informações." — Joseph Joestar

Python MCP Telegram Textual License

3 interfaces · 16 ferramentas · dados reais, nunca inventados

🚀 Instalação · 🖥️ Hermit CLI · 🤖 Hermit Bot · 🛠️ Ferramentas · ⚡ Modo econômico


✨ O que é

Hermit Purplemãos de verdade pra sua IA: busca mangás no MangaDex, escreve código, roda comandos, consulta o clima, salva anotações e conhece o universo de JoJo — tudo com dados reais, nunca alucinados.

Funciona em 3 modos, no PC, Termux (celular) ou servidor:

Modo

O que é

Pra quem é

🖥️ Hermit CLI

Interface estilo Claude Code nas cores roxas do Stand

Quem quer um terminal bonito pra conversar com a IA

🤖 Hermit Bot

Bot do Telegram que responde e executa

Quem quer usar do celular sem abrir terminal

🔌 Servidor MCP

Protocolo padrão da Anthropic

Quem usa Claude Code, Cursor, Codex, LunaCode


Related MCP server: Gemini AI Weather & Calculator Tools

🚀 Instalação

Opção 1: Termux (Android) — recomendo 😎

# 1. Atualiza o Termux (na primeira vez demora uns 2 min)
pkg update -y && pkg upgrade -y

# 2. Instala Python e ferramentas
pkg install python git -y

# 3. Baixa o projeto
git clone https://github.com/jaivedpereira/hermit-purple
cd hermit-purple

# 4. Instala as dependências (SEM o SDK MCP — ele não funciona no Android!)
pip install requests textual httpx

# 5. (opcional) Se quiser o modo servidor MCP puro, rode num PC:
#    pip install "mcp[cli]" requests

Opção 2: Linux / Mac / WSL

# 1. Clona o projeto
git clone https://github.com/jaivedpereira/hermit-purple
cd hermit-purple

# 2. Cria um ambiente virtual (recomendado)
python3 -m venv .venv
source .venv/bin/activate

# 3. Instala as dependências
pip install "mcp[cli]" requests textual httpx

Opção 3: Windows (PowerShell)

# 1. Clona o projeto
git clone https://github.com/jaivedpereira/hermit-purple
cd hermit-purple

# 2. Cria um ambiente virtual
python -m venv .venv
.venv\Scripts\activate

# 3. Instala as dependências
pip install "mcp[cli]" requests textual httpx

🖥️ Hermit CLI — o Claude Code roxo

A interface estilo Claude Code com tema Hermit Purple (fundo preto-roxo, texto lavanda, logo do Stand):

┌─────────────────────────────────────────────────────────┐
│ /new nova conversa   /model modelo   /key chave   ...  │ ← cmdbar
│                                                         │
│              ███  ███  ███  ███                        │
│           HERMIT PURPLE — o Stand da IA                │
│                                                         │
│  🌿 Hermit Purple — o Claude Code do Stand!            │
│  ➤ Você: qual o stand do jotaro?                      │
│  🌿 Hermit Purple: Star Platinum! ORA ORA ORA! ⭐      │
│                                                         │
│  > digite sua mensagem…                                │ ← input
│  v1.0.0 · deepseek-v4-flash-free · 🔑                 │ ← statusbar
└─────────────────────────────────────────────────────────┘

Rodar

python hermit_cli.py

💡 No Termux: o teclado virtual pode não abrir sozinho. Toque no campo de input. Se não abrir: Termux Extra Keys (arraste da borda esquerda) → ícone de teclado, ou Ctrl+Shift+K.

Comandos

Comando

O que faz

/help

Mostra a ajuda

/tools

Lista as 16 ferramentas

/model NOME

Troca o modelo (ex: /model deepseek-v4-flash-free)

/key SK-...

Define a chave da API

/new

Limpa a conversa

/quit

Sai

Atalhos: Ctrl+Q sair · Ctrl+N nova conversa · Ctrl+T ferramentas


🤖 Hermit Bot — o agente no Telegram

Transforma o Hermit Purple num bot do Telegram: você manda mensagem, a IA pensa, chama as ferramentas e responde — mesmo com o celular no bolso. 🔋

Tu (Telegram) → Bot → LLM → chama ferramentas → responde

1. Crie o bot no Telegram (2 minutos)

  1. Abra o @BotFather no Telegram

  2. Envie /newbot

  3. Escolha um nome (ex: Hermit Purple)

  4. Escolha um username (ex: hermit_purple_bot)

  5. Copie o token que ele te der (formato 123456:ABC-DEF...)

2. Configure o bot

# copia o modelo de config
cp .env.example .env

# edita o .env (use nano ou vim) e cola seu token:
nano .env

Dentro do .env:

TELEGRAM_TOKEN=123456:ABC-DEF...          # ← seu token do BotFather
LLM_API_URL=https://opencode.ai/zen/v1/chat/completions
LLM_API_KEY=                              # chave da API (se tiver)
LLM_MODEL=deepseek-v4-flash-free

3. Rode

# em primeiro plano (pra testar)
python hermit_bot.py

# ou em background — fecha o Termux e ele continua vivo!
./run_bot.sh

4. Use

Mande pro seu bot no Telegram:

🗨️ "Tem capítulo novo de Chainsaw Man em português?" 📬 "Cap. 232 — 'Obrigado, Chainsaw Man'! RENTARO SCAN, 02/04/2026. Quer que eu salve pra você lembrar?"

🗨️ "Cria um projeto python chamado app-testes com um main.py que imprime oi" 📬 "✅ Projeto criado em ~/hermit-workspace/app-testes" (e o arquivo já existe no seu celular!)

Comandos: /start boas-vindas · /tools lista ferramentas


🔌 Servidor MCP — pluga na sua IA favorita

Claude Code

claude mcp add hermit-purple -- python hermit_purple.py

OpenCode / LunaCode

Adicione no seu opencode.json:

{
  "mcp": {
    "hermit-purple": {
      "type": "stdio",
      "command": "python",
      "args": ["/caminho/para/hermit-purple/hermit_purple.py"],
      "enabled": true
    }
  }
}

Cursor

Settings → MCP → Add new MCP server:

Tipo:    stdio
Comando: python /caminho/para/hermit-purple/hermit_purple.py

Testar sem IA (MCP Inspector)

pip install "mcp[cli]"
npx @modelcontextprotocol/inspector python hermit_purple.py

🛠️ Ferramentas

📚 Mangá & Anime

Ferramenta

O que faz

buscar_manga

Busca mangás no MangaDex (foco pt-br): título, autor, status, gêneros

detalhes_manga

Ficha completa por ID: sinopse, nota, autores, estatísticas

capitulos_recentes

Últimos capítulos (pt-br) com scanlation e data

buscar_anilist

Anime/mangá no AniList: nota, popularidade, capítulos

💻 Código (sandbox seguro)

Ferramenta

O que faz

criar_projeto

Cria projeto novo (python / html / node)

listar_pasta

Lista arquivos do workspace

ler_arquivo / escrever_arquivo

Lê e edita código

rodar_comando

Executa comandos shell (timeout 60s)

git_status

Status do repositório git

🔒 As ferramentas de código só mexem dentro de ~/hermit-workspace — nunca fora.

🌍 Utilidades

Ferramenta

O que faz

buscar_musica

Músicas no iTunes com preview de 30s

clima

Previsão do tempo (Open-Meteo, sem chave)

salvar_nota / ler_notas

Anotações em ~/.hermit-purple/notas.md

jojo_stand

Base de 13 Stands de JoJo

hora_agora

Data e hora


⚡ Modo econômico

O bot foi feito pra quase não existir no seu celular:

  • 📡 Long polling de 50s — ocioso = ~1 requisição/min (em vez de 60/min). ~98% menos dados

  • 🔄 Backoff exponencial — se a rede cair, espera 1s → 2s → 4s → … até 60s

  • 🔇 Modo silencioso — zero prints, zero IO de console

  • Só processa quando você fala — parado, CPU em repouso total

  • 🪶 Dependência única (requests) — leve, roda no Termux com 2GB de RAM

💡 Resultado: você nem percebe que ele tá ligado — só acorda quando você chama.


⚙️ Variáveis de ambiente

Variável

Obrigatório

Default

Descrição

TELEGRAM_TOKEN

p/ bot

Token do @BotFather

LLM_API_URL

https://opencode.ai/zen/v1/chat/completions

Endpoint OpenAI-compatível

LLM_API_KEY

vazio

Chave da API

LLM_MODEL

deepseek-v4-flash-free

Modelo padrão

ALLOWED_CHATS

vazio = todos

Chat IDs permitidos (segurança)

HERMIT_WORKDIR

~/hermit-workspace

Pasta de trabalho do código

HERMIT_NOTES

~/.hermit-purple/notas.md

Arquivo de anotações

HERMIT_LONG_POLL

50

Segundos do long polling

HERMIT_QUIET

1

1 = silencioso


🧱 Stack

  • Python 3.10+

  • MCP SDK v2 (MCPServer)

  • Textual 8.x — a TUI bonita

  • requests — Telegram API, LLM e APIs públicas

  • APIs sem chave: MangaDex, AniList, iTunes, Open-Meteo

🗂️ Estrutura

hermit-purple/
├── hermit_purple.py   # servidor MCP + 16 ferramentas
├── hermit_bot.py      # bot do Telegram (modo econômico)
├── hermit_cli.py      # TUI roxa estilo Claude Code
├── run_bot.sh         # sobe o bot em background
├── run_cli.sh         # sobe a CLI
├── .env.example       # modelo de configuração
└── requirements.txt   # dependências

🩹 Problemas comuns

Failed to build 'rpds-py' no Termux

Target triple not supported by rustup: aarch64-unknown-linux-android
ERROR: Failed to build 'rpds-py' when installing build dependencies

Por que acontece: o pacote mcp[cli] puxa o rpds-py, que precisa compilar código Rust — e o compilador Rust não suporta o Android do Termux.

Solução: no Termux, não instale o mcp[cli]. O bot e a CLI funcionam só com:

pip install requests textual httpx

O modo servidor MCP puro (pip install "mcp[cli]") é só pra PC / servidor.


🧪 Testes

# testa o servidor MCP (handshake + ferramentas)
python test_mcp.py

# testa a CLI (comandos + agente, headless)
python test_cli.py

📜 Licença

MIT — feito com 🖤💛 e muito respeito a Araki.

"Your next line is... 'código brabo demais'!" 😎

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    C
    quality
    D
    maintenance
    Aggregates multiple third-party APIs into unified MCP tools, providing out-of-the-box access to 10 popular services including OpenWeather, Google Maps, GitHub, Notion, Spotify, and more. Enables users to interact with weather data, search places, manage repositories, create content, and access various web services through a single MCP server.
    34
    MIT
  • A
    license
    -
    quality
    D
    maintenance
    Dynamically generates MCP tools from OpenAPI specifications, enabling AI assistants to interact with any REST API through natural language. Supports multiple APIs with authentication, parameter validation, and integration with Claude Desktop and LangChain.
    1
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    Provides AI agents with 220+ tools for building websites, sending email, managing contacts, invoicing, databases, automation, and more through a single secure connection. Features hardware-bound authentication and works with Claude Desktop, Claude Code, Cursor, and other MCP-compatible clients.

View all related MCP servers

Related MCP Connectors

  • User-owned memory for AI agents, Copilot, Claude, IDEs, CLIs, and chat apps over remote MCP.

  • OCR, transcription, file extraction, and image generation for AI agents via MCP.

  • Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jaivedpereira/hermit-purple'

If you have feedback or need assistance with the MCP directory API, please join our Discord server