Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (create-context-hub) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

create-context-hub

Set up a Context Hub in one command. No cloning, no manual config, no guesswork.

npx create-context-hub

What's new in 0.2.0: Context Hub now works with any MCP client — Claude.ai, Claude Code, Claude App, ChatGPT connectors, Perplexity, Cursor, Windsurf, Zed, and custom agents. The source tag on every memory and log entry is auto-detected from the MCP client's self-reported name during the initialize handshake, so you always know which tool wrote each entry.

The Problem

Every AI tool maintains its own separate context. A memory saved in Claude.ai isn't available in Claude Code, ChatGPT, or Perplexity. You re-explain yourself every time you switch tools. There's no cross-vendor API to bridge them.

What This Creates

A shared MCP server on Cloudflare Workers that every MCP-speaking AI client connects to simultaneously. It stores:

Memories — preferences, facts, learnings
Decisions — what you chose and why
Projects — descriptions and custom instructions per project
Instructions — global behavior rules ("always use TypeScript")
Identity — name, role, expertise, location
Context Log — breadcrumbs across sessions ("discussed auth on phone at 3pm")

24 MCP tools. Full-text search (FTS5). 3-layer deduplication. Runs on Cloudflare's free tier — $0/month.

How It Works

npx create-context-hub
        │
        ├── 1. Prompts for project name
        ├── 2. Scaffolds project files (MCP server, migration SQL, configs)
        ├── 3. Runs npm install
        ├── 4. Authenticates with Cloudflare (opens browser)
        ├── 5. Creates a D1 database on your Cloudflare account
        ├── 6. Patches wrangler.json with the database ID
        ├── 7. Runs database migration (creates 5 tables + FTS indexes)
        ├── 8. Deploys to Cloudflare Workers → gives you a live URL
        ├── 9. (Optional) Generates an API key + sets it as a Wrangler secret
        ├── 10. (Optional) Runs `claude mcp add` to connect Claude Code
        └── 11. Prints connector instructions for every MCP client
                (Claude.ai/App, ChatGPT, Perplexity, Cursor, etc.) + summary

If any step fails, the CLI prints the exact command to run manually. The scaffolded project is always valid — worst case, you finish 2-3 steps yourself.

What Gets Deployed

Claude App (Phone) ─────┐
Claude.ai (Browser) ────┤
ChatGPT (Connector) ────┤   MCP / Custom Connector (HTTPS)
Perplexity ─────────────┤
Cursor / Windsurf ──────┤
Any MCP client ─────────┤
                        ▼
               ┌──────────────────┐
               │  Your MCP Server │    Cloudflare Workers
               │  (24 tools)      │    Free tier ($0/month)
               │                  │    Always on, global edge
               │  Auto-detects    │    source = MCP client name
               │  the caller      │    (claude-code, chatgpt, …)
               └────────┬─────────┘
                        │
                        ▼
               ┌──────────────────┐
               │  Cloudflare D1   │    SQLite database
               │  (5GB free)      │    5M reads/day
               └──────────────────┘
                        ▲
                        │  HTTP transport (MCP)
               ┌────────┴─────────┐
               │  Claude Code /   │
               │  any terminal    │
               │  MCP client      │
               └──────────────────┘

Requirements

Node.js 18+
A free Cloudflare account
Claude Code (optional, for auto-configuration)

Usage

# Interactive — prompts for project name
npx create-context-hub

# Pass project name directly
npx create-context-hub my-hub

# Scaffold only (skip Cloudflare setup)
# Answer "No" when prompted for Cloudflare setup
npx create-context-hub my-hub

What Gets Scaffolded

my-hub/
├── src/
│   └── index.ts            # MCP server (24 tools, ~1700 lines)
├── migrations/
│   └── 0001_init.sql       # Database schema (5 tables + FTS5 indexes)
├── wrangler.json            # Cloudflare Workers config (auto-patched with DB ID)
├── package.json             # Dependencies: @modelcontextprotocol/sdk, agents
├── tsconfig.json
└── .gitignore

After Setup

Once deployed, verify it works from every MCP client you connect:

In Claude.ai or Claude App:

"Who am I? Check your Context Hub."

In Claude Code:

"What do you know about me? Check context hub."

In ChatGPT / Perplexity / Cursor / any other MCP client:

"List my recent memories from context hub."

Cross-client sync:

On your phone (Claude App): "Save this thought: consider migrating to tRPC for the dashboard"
In ChatGPT (browser): "What was I thinking about on my phone?"
In Claude Code (terminal): "Show me everything discussed in ChatGPT today."

Each entry is tagged with the source of the client that wrote it (claude-app, chatgpt, claude-code, …) — auto-detected from the MCP client's self-reported name.

Updating

Your Context Hub is a live MCP server. To update after the main project releases changes:

cd my-hub
git pull origin main  # if tracking upstream
npx wrangler deploy

All connected Claude sessions pick up changes on their next conversation.

claude-context-hub — the full project with documentation, tool reference, and comparison with alternatives

License

MIT