Skip to main content
Glama
cf-knowbase-mcp

cf-knowbase-mcp

by tenfyzhong

cf-knowbase-cli

Unified CLI tool (knowbase) and Model Context Protocol (MCP) server for querying your Cloudflare-backed personal knowledge base.

Security & Architecture

cf-knowbase-cli reads your Cloudflare Worker URL and Bearer Token from a local configuration file or environment variables. This architecture ensures:

  • No Token Leakage: The API token is stored securely on your local filesystem and is never passed as a parameter in tool calls or model prompts.

  • Unified Interface: Use the same client configuration whether querying manually from your terminal (knowbase search) or allowing AI agents (Claude, Codex, OpenCode, etc.) to query on your behalf via MCP.

[ Human Developer ] ────(knowbase search)───┐
                                            ▼
                                   [ cf-knowbase-cli ] ────(POST /search + Bearer)───► [ Cloudflare Worker API ]
                                            ▲
[ AI Coding Agent ] ────(MCP Tool Call)─────┘

Related MCP server: Vectorize MCP Server

Setup & Configuration

Create ~/.config/knowbase/config.json:

{
  "apiUrl": "https://<your-worker-subdomain>.workers.dev",
  "apiToken": "<your-secret-api-token>"
}

Alternatively, set the following environment variables:

export CF_KNOWBASE_API_URL="https://<your-worker-subdomain>.workers.dev"
export CF_KNOWBASE_API_TOKEN="<your-secret-api-token>"

Verify your configuration:

knowbase config
knowbase health

1. CLI Usage

# Semantic search
knowbase search "how does the auth flow work?"

# Retrieve more results
knowbase search "database schema" --top-k 10

# Filter by source (e.g. obsidian notes or blog)
knowbase search "rust memory management" --source obsidian-notes

# Output raw JSON
knowbase search "kubernetes deployment" --json

2. MCP Server (AI Agent Integration)

cf-knowbase-cli includes a standard stdio MCP server (cf-knowbase-mcp) that exposes the search_knowledge_base tool to AI assistants.

Claude Desktop Configuration

Add the following entry to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "personal-knowledge-base": {
      "command": "node",
      "args": ["/path/to/cf-knowbase-cli/dist/mcp.js"]
    }
  }
}

Tool Definition

  • Tool Name: search_knowledge_base

  • Description: Search personal knowledge base (documents, notes, blog posts, repositories) using semantic similarity search.

  • Parameters:

    • query (string, required): The search query or concept.

    • topK (number, optional): Maximum number of results to return (default: 5).

    • source (string, optional): Filter results by source name.


Local Development & Testing

# Install dependencies
pnpm install

# Run unit tests
pnpm test

# Build CLI and MCP binaries
pnpm run build

# Run type checking
pnpm run typecheck

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides search capabilities for Cloudflare AutoRAG instances, enabling AI assistants like Claude to directly search and query knowledge bases using three distinct search methods: basic search, rewrite search, and AI search.
      12
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides semantic search capabilities by connecting Claude Desktop to a Cloudflare Workers backend powered by Vectorize. It enables natural language querying of knowledge bases using vector similarity and edge-based embedding generation.
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to store, search (keyword and semantic), retrieve, update, and delete personal browser clips from a Cloudflare-backed store, authenticated via per-user token.
      1
      -