A self-hostable platform that connects development teams to their technical documentation through AI-native interfaces. Query specs, patterns, and guidelines directly from your IDE via the Model Context Protocol (MCP). Learn more in About.

• MCP-Native -- Model Context Protocol as the sole interface; works with any MCP-compatible IDE or AI tool
• AI-Powered Queries -- Natural language queries against your documentation with cited answers
• Semantic Search -- Vector embeddings for relevance-ranked document retrieval
• Multi-Source Ingestion -- Import from local files and URLs
• Multi-Tenant Architecture -- Organizations and projects with config-driven tenant resolution
• Local-First -- No authentication required; tenant context via HTTP headers
• Self-Hostable -- Deploy on your own infrastructure with Docker

• Docker & Docker Compose
• Node.js 20+ and pnpm

git clone https://github.com/wellitongervickas/knowstack.git
cd knowstack
pnpm install
cp .env.example .env

Starts PostgreSQL, Redis, and the app server in containers.

docker compose up -d
pnpm prisma migrate deploy

Starts only the database and cache in containers; run the server locally.

docker compose up -d db redis
pnpm prisma generate
pnpm prisma migrate dev

The SDK CLI creates your organization, project, ingests documentation, and seeds AI instructions. It works from any directory and prints MCP connection config at the end.

npx @knowstack/sdk --init

See the SDK Setup Guide for full options including named profiles.

Option A: The server is already running at http://localhost:3100.

Option B: Start the server:

pnpm start:dev

Use the MCP config printed by the SDK to connect your IDE. See MCP Integration below.

KnowStack exposes MCP tools for document queries, search, instruction retrieval, and memory management. See the MCP Reference for details.

Claude Code:

claude mcp add knowstack \
  --transport http http://localhost:3100/api/v1/mcp \
  -H "x-ks-org: your-org-slug" \
  -H "x-ks-project: your-project-slug"

VS Code / Cursor (.vscode/mcp.json):

{
  "servers": {
    "knowstack": {
      "type": "http",
      "url": "http://localhost:3100/api/v1/mcp",
      "headers": {
        "x-ks-org": "your-org-slug",
        "x-ks-project": "your-project-slug"
      }
    }
  }
}

• MCP Reference -- Tools, configuration, error handling
• Architecture -- System design and patterns
• Getting Started -- Full setup guide
• Documentation -- Full documentation navigation

Contributions are welcome! Please read our Contributing Guide before submitting a PR.

• Development Setup
• Coding Standards
• Documentation Guide

To report a security vulnerability, please open a private issue on GitHub. See SECURITY.md for details.

This project is licensed under the MIT License. See LICENSE for details.