Jilebi

Um runtime MCP seguro e extensível com plugins JS

Documentação

Jilebi Logo

                              $$$$$\ $$\ $$\           $$\       $$\ 
                              __$$ |__|$$ |          $$ |      __|
                                 $$ |$$\ $$ | $$$$$$\  $$$$$$$\  $$\ 
                                 $$ |$$ |$$ |$$  __$$\ $$  __$$\ $$ |
                           $$\   $$ |$$ |$$ |$$$$$$$$ |$$ |  $$ |$$ |
                           $$ |  $$ |$$ |$$ |$$   ____|$$ |  $$ |$$ |
                           \$$$$$$  |$$ |$$ |\$$$$$$$\ $$$$$$$  |$$ |
                            ______/ __|__| _______|_______/ __|

https://jilebi.ai

Um poderoso servidor MCP (Model Context Protocol) baseado em plugins que estende assistentes de IA com ferramentas, recursos e prompts personalizados.

Sumário

Visão Geral
Download
Instalação
- Windows
- Linux
- macOS
Configuração do Host
Sistema de Plugins
Criando Plugins
Registro e Depuração
Links

Visão Geral

Jilebi é uma implementação de servidor MCP que permite que assistentes de IA interajam com sistemas externos por meio de uma arquitetura modular de plugins. Ele fornece uma maneira padronizada de expor ferramentas, recursos e prompts a modelos de linguagem, mantendo a segurança por meio de um sistema granular de permissões.

Principais Recursos:

Suporte multiplataforma (Windows, Linux, macOS)
Extensibilidade baseada em plugins
Modelo de permissões seguro para acesso a sistema de arquivos e rede
Gerenciamento persistente de estado para plugins
Compatível com os principais ambientes de desenvolvimento de IA

Instalação Rápida

A maneira mais rápida de instalar o Jilebi é usando nossos scripts de instalação:

Linux e macOS

Usando curl:

curl -fsSL https://mcp.jilebi.ai/install.sh | bash

Usando wget:

wget -qO- https://mcp.jilebi.ai/install.sh | bash

Windows (PowerShell)

irm https://mcp.jilebi.ai/install.ps1 | iex

Ou com o comando completo:

Invoke-RestMethod https://mcp.jilebi.ai/install.ps1 | Invoke-Expression

O que o instalador faz

Detecta sua plataforma e arquitetura automaticamente
Baixa o binário apropriado
Instala em ~/.jilebi/bin (Unix) ou %LOCALAPPDATA%\jilebi\bin (Windows)
Adiciona o Jilebi ao seu PATH
Opcionalmente instala plugins recomendados (memória, pensamento sequencial)

Desinstalação

Para remover completamente o Jilebi do seu sistema:

Linux e macOS

Usando curl:

curl -fsSL https://mcp.jilebi.ai/uninstall.sh | bash

Usando wget:

wget -qO- https://mcp.jilebi.ai/uninstall.sh | bash

Windows (PowerShell)

irm https://mcp.jilebi.ai/uninstall.ps1 | iex

Ou com opções:

# Skip confirmation prompts
irm https://mcp.jilebi.ai/uninstall.ps1 -OutFile uninstall.ps1; .\uninstall.ps1 -Force

# Keep plugins and data
irm https://mcp.jilebi.ai/uninstall.ps1 -OutFile uninstall.ps1; .\uninstall.ps1 -KeepData

O que o desinstalador remove

Binário do Jilebi e diretório de instalação
Entrada do PATH no perfil do shell (Unix) ou ambiente do usuário (Windows)
Opcionalmente: plugins, dados e arquivos de configuração

Download Manual

Plataforma	Arquitetura	Download
Windows 10/11	x86_64	Download
Linux	x86_64	Download
macOS	Apple Silicon	Download
macOS	Intel	Download

Instalação Manual

Windows

# 1. Unzip the downloaded file to your desired location

# 2. Install recommended plugins
.\jilebi.exe plugins add memory
.\jilebi.exe plugins add sequential-thinking

# 3. Start the MCP server
.\jilebi.exe stdio

Linux

# 1. Unzip the downloaded file to your desired location

# 2. Grant execution access
chmod +x jilebi

# 3. Install recommended plugins
./jilebi plugins add memory
./jilebi plugins add sequential-thinking

# 4. Start the MCP server
./jilebi stdio

macOS

# 1. Unzip the downloaded file to your desired location

# 2. Grant execution access
chmod +x jilebi

# 3. Remove quarantine attribute (required for unverified developers)
xattr -d com.apple.quarantine /path/to/jilebi

# 4. Install xz dependency
brew install xz

# 5. Install recommended plugins
./jilebi plugins add memory
./jilebi plugins add sequential-thinking

# 6. Start the MCP server
./jilebi stdio

Encontre mais plugins em github.com/datron/jilebi-plugins

Configuração do Host

O Jilebi integra-se a vários ambientes de desenvolvimento de IA. Abaixo estão exemplos de configuração para hosts suportados.

Claude Desktop

Localização da Configuração:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jilebi": {
      "command": "jilebi",
      "args": ["stdio"],
      "env": {}
    }
  }
}

Claude Code

Adicione a .claude.json:

{
  "mcpServers": {
    "jilebi": {
      "command": "jilebi",
      "args": ["stdio"],
      "env": {}
    }
  }
}

Cursor

Edite ~/.cursor/mcp.json:

{
  "mcpServers": {
    "jilebi": {
      "command": "jilebi",
      "args": ["stdio"],
      "env": {}
    }
  }
}

VS Code

Adicione ao seu mcp.json:

{
  "servers": {
    "jilebi": {
      "type": "stdio",
      "command": "jilebi",
      "args": ["stdio"]
    }
  }
}

Zed

Edite ~/.config/zed/settings.json:

{
  "context_servers": {
    "jilebi": {
      "command": "jilebi",
      "args": ["stdio"],
      "enabled": true,
      "source": "custom",
      "env": {}
    }
  }
}

Codex CLI

Adicione a ~/.codex/config.toml:

[mcp_servers.jilebi]
command = "jilebi"
args = ["stdio"]

Opencode

Edite ~/.config/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jilebi": {
      "type": "local",
      "command": ["jilebi", "stdio"],
      "enabled": true,
      "environment": {}
    }
  }
}

Sistema de Plugins

Os plugins estendem o Jilebi com funcionalidades personalizadas por meio de três componentes principais:

Componente	Descrição
Ferramentas	Funções que os modelos podem invocar para interagir com sistemas externos
Recursos	Fontes de dados somente leitura para contexto (arquivos, esquemas, documentação)
Prompts	Modelos de conversação pré-definidos com interpolação de argumentos

Gerenciando Plugins

# Install a plugin
jilebi plugins add <plugin-name>

# Create a new plugin
jilebi plugins create

# Setup/reconfigure a plugin
jilebi plugins setup <plugin-name>

# View plugin logs
jilebi plugins log <plugin-id>

Criando Plugins

Início Rápido

jilebi plugins create

Siga os prompts para inicializar um novo projeto de plugin.

Manifesto do Plugin

Os plugins são definidos usando um arquivo de manifesto TOML. Aqui está um exemplo de estrutura:

# Metadata
name = "my-plugin"
version = "1.0.0"
homepage = "github.com/user/my-plugin"
creator = "Your Name"
contact = "you@example.com"

# Environment Variables
[env]
API_URL = { schema = { type = "string" }, default = "https://api.example.com" }

# Secrets (no defaults allowed)
[secrets]
API_KEY = { schema = { type = "string" } }

# Tools
[tools.my-tool]
name = "my-tool"
description = "Description of what this tool does"
input_schema = { type = "object", properties = { param = { type = "string" } }, required = ["param"] }
function = "my_tool_function"

[tools.my-tool.permissions]
hosts = ["https://api.example.com"]

# Resources
[resources.my-resource]
name = "my-resource"
description = "Description of this resource"
mime_type = "application/json"
function = "get_resource"

# Prompts
[prompts.my-prompt]
name = "my-prompt"
description = "A helpful prompt template"
arguments = [
  { name = "topic", description = "The topic to discuss", required = true }
]
messages = [
  { role = "user", content = { type = "text", content = "Tell me about {{topic}}" } }
]

Tipos de Permissão

Os plugins podem solicitar as seguintes permissões:

Permissão	Descrição
`hosts`	Domínios de host permitidos para solicitações de rede
`urls`	URLs específicas permitidas
`read_files`	Caminhos de arquivo que o plugin pode ler
`write_files`	Caminhos de arquivo que o plugin pode gravar
`read_dirs`	Diretórios dos quais o plugin pode ler
`write_dirs`	Diretórios nos quais o plugin pode gravar

Use "user_defined" para solicitar ao usuário um valor personalizado durante a configuração.

Funções Integradas

Os plugins têm acesso a:

Gerenciamento de Estado:

setState(env, key, value) - Persistir dados entre sessões
getState(env, key) - Recuperar dados persistidos
deleteState(env, key) - Remover dados persistidos

Sistema de Arquivos (API Deno):

Operações de diretório: mkdir, readDir
Operações de arquivo: readFile, writeFile, readTextFile, writeTextFile
Manipulação de arquivos: stat, copyFile, rename, remove
Arquivos temporários: makeTempDir, makeTempFile
E muito mais...

Registro e Depuração

Localizações de Log

Plataforma	Caminho
Windows	`C:\Users\<user>\AppData\Roaming\jilebi\jilebi-server\data\logs`
Linux	`~/.local/share/jilebi-server/logs/`
macOS	`~/Library/Application Support/ai.jilebi.jilebi-server/logs`

Visualizando Logs

# View Jilebi server logs
jilebi log

# View plugin-specific logs
jilebi plugins log <plugin-id>

Escrevendo Logs em Plugins

console.log("Info message");
console.warn("Warning message");
console.error("Error message");
console.debug("Debug message");

Links

_{Construído com a especificação Model Context Protocol (MCP) versão 2025-03-26}