Scraps

Name: Scraps
Author: boykush

by boykush

Scraps is a portable CLI knowledge hub for managing interconnected Markdown documentation with Wiki-link notation.

45 GitHub

No known CVEs

MIT license

Actively maintained

Last commit 1d ago

Works with most clients

Transport: sse, http

0 tools

Grade F

Edit this pageView history

Education Writing

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopsse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "scraps": {
      "command": "<see-readme>",
      "args": []
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/scraps)](https://mcppedia.org/s/scraps)

Read me

What Scraps does

Scraps treats documentation like a programming language. Wiki-linked markdown becomes a typed source, compiling into a static site for readers and into JSON any agent can shell into — turning Karpathy's LLM Wiki pattern into a typed, queryable artifact. CLI primary with companion AI skills, fitting any editor and any LLM agent.

Test This Server

This server supports HTTP transport. Be the first to test it — help the community know if it works.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

41/100across 5 weighted dimensions

How we score →

0255075100

−59

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Scraps safe to use?: Scraps has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Scraps?: Scraps can be installed by cloning its GitHub repository and following the setup instructions in the README.
What AI clients work with Scraps?: Scraps is compatible with claude-desktop, cursor, claude-code. It uses sse and http transport.
Is Scraps actively maintained?: Scraps is actively maintained — last commit was 1 day ago. It has 45 GitHub stars.

Similar servers

Others in education / writing

View all →

Auto Claude Code Research In Sleep92

ARIS ⚔️ (Auto-Research-In-Sleep) — Lightweight Markdown-only skills for autonomous ML research: cross-model review loops, idea discovery, and experiment automation. No framework, no lock-in — works with Claude Code, Codex, OpenClaw, or any LLM agent.

12.8k 5

Md2wechat Skill92

Markdown to WeChat CLI | 一键排版发布到微信公众号：支持 40+ 排版样式和专业主题、AI 配图、批量发布

3.0k 14

Sub Agents Mcp91

Define task-specific AI sub-agents in Markdown for any MCP-compatible tool.

89 1

Clarifyprompt MCP Server90

AI prompt optimization for 58+ platforms across 7 categories with custom platforms

11 1

MCP Security Weekly

Get CVE alerts and security updates for Scraps and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Scraps

The Wiki-link doc compiler for the LLM era.

Scraps treats documentation like a programming language. Wiki-linked markdown becomes a typed source, compiling into a static site for readers and into JSON any agent can shell into — turning Karpathy's LLM Wiki pattern into a typed, queryable artifact. CLI primary with companion AI skills, fitting any editor and any LLM agent.

Quick start

# Install brew install boykush/tap/scraps # or: cargo install scraps # Compile a wiki mkdir my-wiki && cd my-wiki scraps init scraps build # Query the same source from a shell or AI agent scraps search "release checklist" --json scraps links "Configuration" --json scraps lint

How it works

graph LR Source[Markdown sources] --> IR[Scraps IR — typed graph] IR --> HTML[Static HTML] IR --> JSON[CLI JSON]

Scraps reads [[wiki-link]], #[[tag]], ![[embed]], [[Page#heading]], and ctx_path as typed primitives. The same source compiles to an HTML site for human readers and to JSON for scripts and AI agents.

AI integration

CLI + JSON is the primary path — any shell-capable agent can query Scraps without an MCP client implementation. Bundled plugins provide agent-facing workflows:

scraps — Karpathy-style Ingest / Query / Lint skills for Claude Code and Codex, plus Claude Code agents for purpose-driven lint and the default Scraps LLM Wiki schema

mcp-server — MCP server for MCP-compatible clients

Frequently Asked Questions

Is Scraps safe to use?

Scraps has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install Scraps?

Scraps can be installed by cloning its GitHub repository and following the setup instructions in the README.

What AI clients work with Scraps?

Scraps is compatible with claude-desktop, cursor, claude-code. It uses sse and http transport.

Is Scraps actively maintained?

Scraps is actively maintained — last commit was 1 day ago. It has 45 GitHub stars.

Scraps

The Wiki-link doc compiler for the LLM era.

Scraps treats documentation like a programming language. Wiki-linked markdown becomes a typed source, compiling into a static site for readers and into JSON any agent can shell into — turning Karpathy's LLM Wiki pattern into a typed, queryable artifact. CLI primary with companion AI skills, fitting any editor and any LLM agent.

Quick start

# Install
brew install boykush/tap/scraps    # or: cargo install scraps

# Compile a wiki
mkdir my-wiki && cd my-wiki
scraps init
scraps build

# Query the same source from a shell or AI agent
scraps search "release checklist" --json
scraps links "Configuration" --json
scraps lint

See the Getting Started tutorial for the full flow.

How it works

graph LR
  Source[Markdown sources] --> IR[Scraps IR — typed graph]
  IR --> HTML[Static HTML]
  IR --> JSON[CLI JSON]

AI integration

CLI + JSON is the primary path — any shell-capable agent can query Scraps without an MCP client implementation. Bundled plugins provide agent-facing workflows:

scraps — Karpathy-style Ingest / Query / Lint skills for Claude Code and Codex, plus Claude Code agents for purpose-driven lint and the default Scraps LLM Wiki schema
mcp-server — MCP server for MCP-compatible clients

See the AI integration guide for the trade-offs.

Documentation

Documentation site — Tutorial, How-to, Reference, Explanation
Sample wiki — Japanese knowledge base built with Scraps

Screenshots

Search, pagination, and Wiki-link navigation, themed with Nord.

Light mode

Contributing

Bugs, feature requests, and PRs are welcome. See CONTRIBUTING.md, the issue templates, and the Code of Conduct.

License

MIT