Files
holocron/.agents/skills/neuledge-context/references/http-mode.md
Defame1297 75c6ea1dd5 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
2026-06-20 23:16:27 +00:00

1.5 KiB

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

# 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

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:

{
  "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:

context serve --http 8080 --host 0.0.0.0 --libs react next typescript