git404hub

what is search-mcp fr?

skyphusion-labs/search-mcp — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

tl;dr

An open source toolkit for Cloudflare AI Search that gives you an MCP server for AI agents, a streaming ask endpoint for a website widget, and tools to sync your git repos into a searchable index.

vibe map

mindmap
  root((search-mcp))
    What it does
      MCP search tool
      Streaming ask endpoint
      Git to R2 sync
    Tech stack
      TypeScript
      Cloudflare Workers
      R2 storage
    Use cases
      Agent search tool
      Docs ask widget
      Auto reindexing
    Audience
      Developers
      Docs teams
    License
      AGPL v3
      Copyleft

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Give an AI coding agent a search tool over your own documentation or codebase.

VIBE 2

Add an ask-the-docs chat widget to a documentation website.

VIBE 3

Keep a Cloudflare AI Search index automatically synced with your git repositories.

what's the stack?

TypeScriptCloudflare WorkersCloudflare R2MCP

how it stacks up fr

skyphusion-labs/search-mcp0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardeasy
Complexity4/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires a Cloudflare account with R2 and AI Search provisioned, plus per-target config files.

You can use and modify the code freely, but if you run a modified version as a network service you must share your source code changes too.

in plain english

search-mcp is an open source toolkit built around Cloudflare's AI Search product, designed to let you turn a set of documents or code repositories into a searchable knowledge base that both people and AI agents can query. The toolkit is made of three main pieces. The first is an MCP Worker, a small server that exposes a search tool over the Model Context Protocol so AI coding agents can look things up, protected by a bearer token. The second is a Query Worker, which handles a streaming ask endpoint meant for a browser based widget, with rate limiting, cross origin protection, and an optional Turnstile human check. The third piece is a corpus sync tool, a set of scripts that pull files from git repositories and upload them into a Cloudflare R2 storage bucket, renaming file extensions like TypeScript or Dockerfiles so Cloudflare's AI Search will actually index them instead of skipping them as non text files. The corpus sync tool and the browser widget files are published as an npm package, while the two Workers themselves need to be deployed separately from a cloned copy of the repository, each with its own configuration file for account, storage bucket, and which repositories to index. Once running, the ask widget can be dropped into any documentation site with a small script tag, and the MCP server can be added to any agent tool that speaks the Model Context Protocol, using a bearer token for access control. The project also includes careful handling for keeping the search index up to date: before asking Cloudflare to reindex the content, the sync scripts wait for any already running reindex job to finish and for a short cooldown period afterward to clear, so a new reindex job reliably includes everything that was just uploaded. The code is released under the AGPL v3 license, a copyleft license that requires anyone who runs a modified version of the software as a network service to share their source code changes too.

prompts (copy fr)

prompt 1
Help me deploy the MCP Worker and Query Worker from this repo to my Cloudflare account.
prompt 2
Show me how to configure targets.json to sync my own repositories into R2.
prompt 3
Explain how to add the ask-widget to my documentation site.
prompt 4
Help me wire this MCP server into my AI agent's tool list with a bearer token.

Frequently asked questions

what is search-mcp fr?

An open source toolkit for Cloudflare AI Search that gives you an MCP server for AI agents, a streaming ask endpoint for a website widget, and tools to sync your git repos into a searchable index.

What language is search-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Cloudflare Workers, Cloudflare R2.

What license does search-mcp use?

You can use and modify the code freely, but if you run a modified version as a network service you must share your source code changes too.

How hard is search-mcp to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is search-mcp for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.