Skip to main content
Glama
Sign In
50 First Tapes MCP Server

50 First Tapes MCP Server

by adilzuberi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

50 First Tapes

An open, local-first knowledge engine. Your notes are plain markdown and git — the tapes; your AI reads and writes them behind governance gates. No lock-in: git clone and walk away.

Apache-2.0 · OKF-compatible · TypeScript. The v1 protocol verbs work today. This repo is the engine and carries no personal data.

Why

Knowledge that outlives any one tool or chat, that an AI agent can read and write safely, and that you can build products on — a personal vault, a team wiki, an agentic LMS. The field converged on this pattern in 2026 (Karpathy's LLM wiki, Google's Open Knowledge Format). 50 First Tapes adds the hard parts those leave out: trust, governance, multi-agent writes, and a typed schema system.

Related MCP server: Link

The layers

Products & views    — your vault · a team wiki · an agentic LMS
Agents & governance — crew + rules as data; gates; audit; the loop runner
Protocol            — ingest · query · lint · write · govern   (MCP · CLI · library)
Derived index       — full-text + vector + graph; rebuilt on demand; never committed
Substrate           — markdown + YAML + git; OKF-compatible; the durable floor

The verbs

One protocol, three shapes — a CLI (tapes), an MCP server, and a library. The five verbs:

Verb

What it does

ingest

Bring raw material in as a governed, kind-scaffolded note. Gates block; schema gaps are reported, not blocked.

query

Find notes by free text (title-weighted), kind, tag, status, or backlinks. Reads on demand — no committed index.

lint

Validate every note against its kind, and check structural health: broken/stale links, orphans, committed blobs, hot-core budget.

write

Write exact content to a note id, through the governance gates.

govern

Dry-run the gates on proposed content without writing.

tapes lint                                  # validate the bundle in the current dir
tapes query "vector search" --kind note     # find notes
tapes ingest article.md --kind source       # file new material under inbox/
tapes govern wiki/draft draft.md            # would this write be accepted?

Governance. Writes pass gates before they land: an off-limits path (private, secrets) or a credential-like string is refused and nothing is written. Edits are hash-anchored — patch replaces a paragraph by its content hash and is rejected if that content has moved, so concurrent edits never clobber.

Packages

  • @50firsttapes/core — schema system, validator, structural-health checks, query, ingest, governance gates, hash-anchored edits, OKF read/write.

  • @50firsttapes/cli — the tapes command: ingest · query · lint · write · govern.

  • @50firsttapes/mcp — a stdio or HTTP MCP server exposing the verbs to any client (Claude Code, Codex, claude.ai). The native tools — read (query/read/list/lint) and gated write (write/patch/govern) — plus wiki-mcp-compatible tools (session_bootstrap, search, read_note, list_folder, get_recent_logs) so it can stand in for the read-only wiki-mcp gateway.

  • @50firsttapes/remote — a git-remote adapter (Forgejo · GitHub · bare). 50 First Tapes depends on git, never on a forge.

Quickstart

pnpm install
pnpm build
node packages/cli/dist/index.js lint examples/sample-bundle
node packages/cli/dist/index.js query --kind note --bundle examples/sample-bundle

Run the MCP server over a bundle. Stdio is the default (local clients like Claude Code):

TAPES_BUNDLE=/path/to/bundle node packages/mcp/dist/index.js

For hosted use, serve over HTTP with Bearer auth (discovery is open; tool calls require a token):

TAPES_HTTP_PORT=8080 TAPES_MCP_TOKEN=sk-… TAPES_BUNDLE=/path/to/bundle node packages/mcp/dist/index.js

Source of truth

Forgejo is the canonical remote; GitHub is a one-way push mirror. Contribute via Issues and PRs on GitHub — see CONTRIBUTING.md.

Licence

Apache-2.0.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • brain-mcp

      kaeldominion
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to securely read and write to an Obsidian-compatible Markdown vault with per-agent access control, audit logging, and conflict resolution.
      Apache 2.0

    • Link

      gowtham0992
      A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to capture, structure, remember, and retrieve source-backed memory as local Markdown files, with reviewable writes and no cloud dependency.
      218
      MIT

    • secondbrain-mcp

      stone1524
      A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to securely read, search, and write to a local Markdown knowledge base with hybrid RAG retrieval, privacy zones, hash-locked writes, audit logging, and rollback-safe archiving.
      13
      MIT

    • wikicore

      carlaost
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to build and maintain a shared, git-backed Markdown wiki: they search, file, update and link notes with YAML frontmatter, keep verbatim sources, and optionally read code repos, so knowledge one assistant records is available to all the others. Runs without LLM calls, embeddings or a database, with the vault's own files defining page types, instructions and tools.
      MIT