Files
context-kit/docs/troubleshooting.md
Ajay Krishnan c905cf86c8 Initial public release
Three local MCP servers for coding agents, designed for Claude Code
and OpenCode:

- context-web-search: SearXNG-backed web search and URL fetch
- context-docs:       semantic search over curated llms.txt docs
- context-repomix:    pack local or remote repos into AI context

Defaults are local-first: SearXNG binds to 127.0.0.1, no hosted API
keys are required, and Repomix mounts only the current project read-only.
2026-05-21 08:43:38 -07:00

753 B

Troubleshooting

Run Doctor

bin/context-kit doctor

This checks Docker, Compose, images, the Docker network, SearXNG health, and docs source configuration.

SearXNG Is Not Responding

Start it:

bin/context-kit start

Then check:

curl 'http://127.0.0.1:8099/search?q=test&format=json'

If you changed CONTEXT_KIT_SEARXNG_PORT, use that port instead.

MCP Image Missing

Build default images:

bin/context-kit build

Docs Indexing Is Slow

The first run downloads an embedding model and embeds every configured docs section. Keep default sources small, and add profiles only when you need them.

Cloudflare and other large docs sets can take significantly longer than the default source profile.