Tags: vericontext/contextix
Tags
Add MCP ingest — turn any MCP server into graph via skill files
The primary wedge of contextix. Every MCP server in the ecosystem is
now a potential data source, addressable through a single `.mjs`
skill file that tells contextix which tools to call and how to shape
the results into graph nodes/edges.
New surface:
- src/ingest/mcp.ts — launches MCP server via @modelcontextprotocol/sdk StdioClientTransport, runs skill.run(ctx), collects emits
- src/skill/types.ts — SkillDefinition, SkillContext, EmitAPI, defineSkill helper
- src/skill/index.ts — subpath export re-exporting the types
- `contextix/skill` — new package subpath export so skill authors can `import { defineSkill } from "contextix/skill"`
- CLI — new `mcp` kind on `ingest <kind> <source>`; --skill flag accepted
Skill authoring model:
- Imperative JS/TS run({mcp, emit, log}) function (not declarative YAML)
- Chosen over YAML because authors are devs, full async/JSON manipulation power, no templating DSL to maintain
- mcpServer spec matches .mcp.json shape (command/args/env with ${VAR} interpolation)
- requiredEnv array for eager env validation
- Deterministic entity/event/relation IDs (hashed); emit helpers dedup across a run
Reference skills in examples/skills/:
- hackernews-top.mjs — keyless, 20 stories + author entities (tested live)
- coingecko-markets.mjs — needs COINGECKO_DEMO_API_KEY, top coins + global snapshot
- arxiv-ai.mjs — keyless, recent cs.AI/cs.CL/cs.LG papers + authors
- README.md — skill-authoring guide
Positioning updates:
- README hero leads with `contextix ingest mcp`, MCP ecosystem story
(10,000+ servers, zero graph layer) as the wedge
- Competitor table adds "MCP ecosystem ingest" row — unique feature
- ROADMAP Phase 1 MCP skills section marked COMPLETED; v0.4 roadmap
for `contextix skills install` + @contextix/skills-* packs
- CHANGELOG 0.3.0 entry expanded
Companion to contextix-platform: the platform's private
.claude/skills/mcp-*-patterns.md reference content becomes the
canonical source of ingest skill knowledge. Future releases will
port these patterns into shipped skill files.
Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>