sibyl MCP工具

One-line setup (installs proto, moon, toolchain, dependencies)

./setup-dev.sh

Shell Installer

curl -fsSL https://raw.githubusercontent.com/hyperb1iss/sibyl/main/install.sh | sh

The installer puts sibyl on your PATH, starts the local API + web stack, and opens the setup UI when it is ready. Use --remote for CLI-only installs and --daemon for the embedded daemon without the web UI.

Docker Self-Host

sibyl docker init       # Generate ~/.sibyl/docker/.env + compose
sibyl docker up         # Start API, web, and SurrealDB
sibyl docker logs       # Follow logs
sibyl docker down       # Stop services
sibyl docker upgrade    # Pull and recreate

Development Setup

```bash

Install CLIs globally (editable, source changes reflect immediately)

moon run install-dev

Deployment

Docker Compose

sibyl docker init
sibyl docker up

⚡ Quickstart

Configure

cp .env.example .env

Embeddings use SIBYL_OPENAI_API_KEY or SIBYL_GEMINI_API_KEY.

Launch the default local-dev stack (SurrealDB + API + web)

moon run dev

The Tool API

Sibyl exposes eleven MCP tools, organized by what they do:

API Keys (Programmatic Access)

```bash sibyl auth api-key create --name "CI/CD" --scopes mcp,api:read

Scopes: mcp, api:read, api:write

```

What LLM APIs do I need?

- Anthropic, OpenAI, or Gemini (required): for language-model surfaces such as crawler extraction, synthesis, and reflection. - OpenAI or Gemini (required): for embeddings and semantic search.

Providers and models are configurable globally or per surface, and the web admin settings page can save instance-wide model routing. A typical solo developer uses around $5/month in API costs.

Package wake-up context for the next coding session

sibyl session bundle ```

Task workflow

sibyl task list --status todo,doing sibyl task start <task_id> sibyl task complete <task_id> --learnings "Key insight: check TTL first"

Task Workflow

backlog ──▶ todo ──▶ doing ──▶ review ──▶ done ──▶ archived
                       │
                       ▼
                    blocked

MCP Integration

Connect Claude Code, Cursor, or any MCP client to Sibyl:

{
  "mcpServers": {
    "sibyl": {
      "type": "http",
      "url": "http://localhost:3334/mcp",
      "headers": {
        "Authorization": "Bearer sk_your_api_key"
      }
    }
  }
}

How does it compare to Mem0 / LangMem / similar?

Sibyl is self-hosted and open source. You own your data. It includes a full task workflow system, not just memory. It has a web UI for humans, not just APIs for machines. And it keeps knowledge, tasks, and docs connected in one graph instead of scattering them across tools.

FAQ