feat(skills): add neuledge-context skill for @neuledge/context MCP server
Adds a complete cross-cutting skill to install, configure, and manage @neuledge/context — a local-first MCP server that delivers version-specific library docs to AI agents via SQLite FTS5. Includes: - SKILL.md with 9-step process: install, global MCP registration, per-project --libs scoping, package management, auth, custom registry, upgrade, uninstall - setup-neuledge-context.sh: pinned version install, idempotent version check - secure-context-config.sh: chmod 600 on ~/.context/config.json after auth - 13-case test suite covering both scripts (all pass) - eval.yaml with 6 trigger tests and 4 output tests - references/: context-cli-reference.md, http-mode.md, install-notes.md Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TP4EGbBg3XMcyF28Lx78XJ
This commit is contained in:
53
.agents/skills/neuledge-context/references/http-mode.md
Normal file
53
.agents/skills/neuledge-context/references/http-mode.md
Normal file
@@ -0,0 +1,53 @@
|
||||
# HTTP / Docker Mode
|
||||
|
||||
`context serve` can run as an HTTP MCP server instead of stdio. Use this when you need to share a single context server across multiple agents, run it in a container, or expose it to remote clients.
|
||||
|
||||
## Start as HTTP server
|
||||
|
||||
```bash
|
||||
# Localhost only (default)
|
||||
context serve --http
|
||||
|
||||
# Specific port
|
||||
context serve --http 3000
|
||||
|
||||
# All interfaces (for Docker or remote access)
|
||||
context serve --http 8080 --host 0.0.0.0
|
||||
```
|
||||
|
||||
## Docker
|
||||
|
||||
```bash
|
||||
docker run -p 8080:8080 \
|
||||
-v ~/.context:/root/.context \
|
||||
neuledge/context \
|
||||
context serve --http 8080 --host 0.0.0.0
|
||||
```
|
||||
|
||||
The volume mount (`-v ~/.context:/root/.context`) reuses packages already downloaded on the host. Omit it if you want an isolated container with its own package store.
|
||||
|
||||
## Client configuration
|
||||
|
||||
Point remote agents at `http://<host>:8080` as an HTTP MCP server. For Claude Desktop, Cursor, or VS Code Copilot, use the same JSON structure as stdio mode but set `url` instead of `command`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"context": {
|
||||
"url": "http://localhost:8080"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Security note
|
||||
|
||||
HTTP mode has no built-in authentication. Do not expose `--host 0.0.0.0` on a public interface without a reverse proxy or firewall rule. On shared systems, bind to `127.0.0.1` (the default) and use an SSH tunnel if remote access is needed.
|
||||
|
||||
## Scope restriction
|
||||
|
||||
`--libs` works in HTTP mode the same as in stdio mode:
|
||||
|
||||
```bash
|
||||
context serve --http 8080 --host 0.0.0.0 --libs react next typescript
|
||||
```
|
||||
Reference in New Issue
Block a user