mcpField
M
mcp-curiosity-engine

mcp-curiosity-engine

Local
github.com/onetrueclaude-creatorMemory & Knowledge0Updated 28w ago
Repository

About mcp-curiosity-engine

mcp-curiosity-engine finds overlooked notes in Markdown vaults using wikilink structure and file age. It is for people revisiting personal knowledge collections, with tools for identifying dormant notes and, in its extended tier, suggesting cross-domain connections.

Key features

  1. 01Identify dormant notes by links and age
  2. 02Find notes with no incoming wikilinks
  3. 03Sample notes for replay cycles
  4. 04Find cross-domain note connections
  5. 05Select a random dormant note

Use cases

  1. 01Find old, rarely linked notes to revisit
  2. 02Locate notes isolated from the rest of a vault
  3. 03Explore connections across top-level folders
  4. 04Rediscover a dormant note at random

MCP support

It exposes MCP tools to find dormant and orphan notes, suggest replay cycles, surface cross-domain bridges, and select a random dormant note.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "onetrueclaude-creator-mcp-curiosity-engine": {
      "command": "uvx",
      "args": [
        "mcp-curiosity-engine"
      ],
      "env": {
        "CURIOSITY_ENGINE_LICENSE": "<CURIOSITY_ENGINE_LICENSE>"
      }
    }
  }
}
Run commanduvx mcp-curiosity-engine
Environment variables to set
CURIOSITY_ENGINE_LICENSESecretPro license JWT (optional). Unlocks premium features. See README.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-curiosity-engine0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

mcp-curiosity-engine

Surface the notes you forgot you wrote — DMN replay for markdown vaults.

Surface the notes you've forgotten you wrote. Uses wikilink graph structure + file mtime to identify dormant notes (low link-in count, old, isolated) and the DMN-inspired replay cycle pattern from cognitive neuroscience: sample dormant notes with bias (40% random / 30% least-linked / 30% orphaned), generate cross-domain bridge queries between them, and surface the unexpected connections. Breaks the confirmation-bias loop where you only revisit the notes you already remember.

Install

pip install mcp-curiosity-engine
# or
uvx mcp-curiosity-engine

Usage

Claude Code
claude mcp add mcp-curiosity-engine -- mcp-curiosity-engine
Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "curiosity_engine": {
      "command": "uvx",
      "args": ["mcp-curiosity-engine"]
    }
  }
}

MCP Tools

ToolTierDescription
find_dormant_notesFreeList notes that are structurally dormant — low incoming wikilink count AND old mtime. These are the notes most at risk of being forgotten.
find_orphan_notesFreeList notes with zero incoming wikilinks — structurally isolated, the extreme case of dormancy.
suggest_replay_cycleProRun the full DMN-inspired replay cycle: sample dormant notes with bias (40% random / 30% least-linked / 30% orphans), extract their concepts, generate cross-domain bridge queries between them, return notes to revisit. The core moat.
find_cross_domain_bridgesProSurface pairs of notes from DIFFERENT top-level directories that share concepts. These are the surprise connections — ideas that span your vault's silos.
random_deep_cutProPull a single random dormant note for serendipitous rediscovery. Think of it as your vault's shuffle-play button.

Pro tier

Unlocks the full DMN replay cycle, cross-domain bridge discovery, and random deep-cut sampling.

License activation — any one of these works:

# 1. Environment variable
export CURIOSITY_ENGINE_LICENSE="eyJhbGc..."

# 2. CLI flag
mcp-curiosity-engine --license-key "eyJhbGc..."

# 3. Config file
echo "eyJhbGc..." > ~/.mcp-curiosity-engine/license.jwt

Licenses are verified fully offline — no phone-home, no activation server. Get a license at https://github.com/onetrueclaude-creator/mcp-curiosity-engine#pro-tier.

Requirements

  • Python 3.10+

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.