菜单
Start the Context Keeper MCP server locally for testing. Use when the user wants to run the stack, test MCP tools end-to-end, verify a build, smoke-test changes, or needs a live server to interact with.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | run-local-stack |
| description | Start the Context Keeper MCP server locally for testing. Use when the user wants to run the stack, test MCP tools end-to-end, verify a build, smoke-test changes, or needs a live server to interact with. |
make dev
Or directly:
./scripts/dev-server.sh
This builds context-keeper-mcp in debug mode and starts it with:
| Setting | Value |
|---|---|
| Transport | HTTP |
| Port | 3000 |
| Storage | In-memory (clean every run) |
| Auth | Disabled |
| Logging | context_keeper=debug |
Run make dev in a background terminal (block_until_ms: 0). The server is ready when you see output containing Listening or StreamableHttp.
If you need seed data pre-loaded:
make dev-seed
Send an MCP initialize request:
curl -s http://localhost:3000/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}'
A successful response contains "result" with serverInfo and capabilities.
Call any tool through the MCP JSON-RPC interface. Example — list tools:
curl -s http://localhost:3000/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
Send SIGINT (Ctrl+C) to the terminal running the server, or kill the process.
Override any default by setting the env var before the command:
# Different port
./scripts/dev-server.sh --port 4000
# Less noisy logs
./scripts/dev-server.sh --log-level info
# Persistent storage instead of memory
STORAGE_BACKEND=rocksdb:./test-data ./scripts/dev-server.sh
# Release build
./scripts/dev-server.sh --release
| Problem | Fix |
|---|---|
Address already in use | Another process on port 3000. Use --port 3001 or lsof -i :3000 to find it. |
| Build fails with clang errors | SurrealDB needs clang: brew install llvm (macOS) or apt install clang (Linux). |
| Server starts but tools return empty results | Expected with STORAGE_BACKEND=memory — no data persists. Use --seed or ingest data via the add_memory tool first. |
MCP_AUTH_TOKENS errors | The dev script sets MCP_ALLOW_INSECURE_HTTP=1. If you override it, you need to provide tokens. |
Listening or StreamableHttp appears in logsinitialize returns a valid responsetools/list, add_memory, search_memory)Add a new trait to context-keeper-core with a mock implementation. Use when adding a new abstraction, capability, or extension point to the core crate.
Add a new MCP tool to the Context Keeper server. Use when adding a tool, implementing a new MCP capability, or extending the server's tool surface.
Run the full Context Keeper test suite and diagnose failures. Use when the user asks to run tests, check if tests pass, verify changes didn't break anything, or troubleshoot test failures.
Workflow for picking up and implementing a Linear issue for Context Keeper. Use when starting work on an FZ-* issue, creating a feature branch, or following the project's branching and issue workflow.