开源MCP工具

Prerequisites

• Bun >= 1.0
• Git

💡 What people build with KinBot

DevOps copilot — A Kin connected to GitHub webhooks triages new issues, reviews PRs, runs CI checks, and creates releases. It remembers your codebase conventions and past decisions. Cron jobs monitor infrastructure and alert you on Telegram.

Home automation brain — A Kin talks to Home Assistant via MCP, learns your routines over time, and adjusts lighting/heating based on context. Ask it "why was the heating on last night?" and it remembers.

Personal knowledge base — Upload docs, meeting notes, project specs. A Kin indexes everything with RAG and answers questions across months of accumulated context. Unlike ChatGPT, it never forgets previous conversations.

Multi-agent team — A dispatcher Kin receives requests and delegates to specialists (one for code, one for sysadmin, one for writing). They collaborate, share context through memories, and report back.

Business monitoring — Webhooks feed sales data, support tickets, or server metrics into a Kin. It builds mini-app dashboards, sends daily Slack summaries, and flags anomalies before you notice them.

Family assistant — Multiple users share the same instance. One Kin manages groceries via Telegram, another handles kids' schedules, another tracks household tasks. Each remembers everyone's preferences.

---

One-liner install (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/MarlBurroW/kinbot/main/install.sh | bash

This script will: 1. Install Bun if not already present 2. Clone the repository to /opt/kinbot 3. Install dependencies and build the frontend 4. Run database migrations 5. Create a system service (systemd on Linux, launchd on macOS) 6. Start KinBot on port 3000

Customizable via env vars:

KINBOT_DIR=/home/me/kinbot \
KINBOT_DATA_DIR=/home/me/kinbot-data \
KINBOT_PORT=8080 \
  bash <(curl -fsSL https://raw.githubusercontent.com/MarlBurroW/kinbot/main/install.sh)

Docker Compose

git clone https://github.com/MarlBurroW/kinbot.git
cd kinbot/docker
ENCRYPTION_KEY=$(openssl rand -hex 32) docker compose up -d

See docker/docker-compose.yml for full options.

Setup

git clone https://github.com/MarlBurroW/kinbot.git
cd kinbot
bun install
bun run dev    # Starts Vite dev server (port 5173) + Hono backend (port 3333)

The dev server proxies API requests from port 5173 to 3333 automatically.

or with Docker:

docker run -d -p 3001:3000 ghcr.io/marlburrow/kinbot:latest

#### Database migration errors after update

If you see migration errors after updating KinBot:

Rebuild the frontend

bun run build

🚀 Quick Start

docker run -d --name kinbot -p 3000:3000 -v kinbot-data:/app/data ghcr.io/marlburrow/kinbot:latest

Open http://localhost:3000 — done. The onboarding wizard handles the rest.

<details> <summary><strong>Other install methods</strong> (one-liner script, Docker Compose, manual)</summary>

Configuration

Copy .env.example to .env and adjust as needed. All values have sensible defaults — you can start with an empty .env.

See .env.example for the complete list of all options (compacting thresholds, memory tuning, queue settings, cron limits, web browsing, etc.).

---

⚙️ Environment Variables

All settings have sensible defaults. Override only what you need.

<details> <summary><strong>Full configuration reference</strong></summary>

Core

Memory & Compacting

Tasks & Queues

Cron & Automation

Inter-Kin Communication

Channels & Webhooks

File Storage & Uploads

Vault

Workspaces & Mini Apps

Web Browsing

MCP & Human-in-the-Loop

Sessions & Invitations

Notifications

Wakeups

Version Check

</details>

---

🔧 Troubleshooting

<details> <summary><strong>Common issues and solutions</strong></summary>

Port already in use

Error: listen EADDRINUSE :::3000

Another process is using port 3000. Either stop it or change KinBot's port:

```bash PORT=3001 bun src/server/index.ts