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.
This commit is contained in:
55
docs/assistants.md
Normal file
55
docs/assistants.md
Normal file
@@ -0,0 +1,55 @@
|
||||
# Assistant Setup
|
||||
|
||||
Context Kit supports any assistant that can run local stdio MCP servers. The
|
||||
included snippets cover Claude Code and OpenCode.
|
||||
|
||||
## Claude Code
|
||||
|
||||
Print a project `.mcp.json` snippet:
|
||||
|
||||
```sh
|
||||
bin/context-kit install claude
|
||||
```
|
||||
|
||||
The default snippet uses `context-kit` on `PATH`, which is appropriate for
|
||||
committed project config. For private user-only config, you can print absolute
|
||||
paths with:
|
||||
|
||||
```sh
|
||||
bin/context-kit install claude --absolute
|
||||
```
|
||||
|
||||
Claude Code also supports adding stdio servers through its CLI. Use absolute
|
||||
paths if `context-kit` is not on your `PATH`.
|
||||
|
||||
After configuration, open Claude Code and run:
|
||||
|
||||
```text
|
||||
/mcp
|
||||
```
|
||||
|
||||
You should see:
|
||||
|
||||
- `context-web-search`
|
||||
- `context-docs`
|
||||
- `context-repomix`
|
||||
|
||||
## OpenCode
|
||||
|
||||
Print an `opencode.json` MCP snippet:
|
||||
|
||||
```sh
|
||||
bin/context-kit install opencode
|
||||
```
|
||||
|
||||
Merge the printed `mcp` block into your OpenCode config and restart OpenCode.
|
||||
OpenCode reads config at startup.
|
||||
|
||||
Use `bin/context-kit install opencode --absolute` only for private machine-local
|
||||
config that will not be committed.
|
||||
|
||||
## Suggested Agent Instructions
|
||||
|
||||
Use the snippets in `snippets/CLAUDE.md` and `snippets/AGENTS.md` as a starting
|
||||
point. They remind agents to use docs search before guessing API details and to
|
||||
treat fetched web pages as untrusted input.
|
||||
Reference in New Issue
Block a user