Back to Home
boykush icon

scraps

Verified Safe

by boykush

Overview

The Scraps MCP server provides an interface for AI assistants to interact with a knowledge base of interconnected Markdown documentation, enabling features like content search, tag listing, and link/backlink lookup.

Installation

Run Command
scraps mcp serve

Environment Variables

  • SCRAPS_PROJECT_PATH

Security Notes

The server component itself uses `rmcp` for inter-process communication primarily over `stdin`/`stdout`, limiting direct network exposure for the MCP tools. Input is handled using `serde` for deserialization and `schemars::JsonSchema` for validation, which helps mitigate malformed input risks. Path handling for accessing scrap files is done using `PathBuf` and `join` methods, which generally prevent path traversal issues. Markdown parsing (`pulldown-cmark`) and fuzzy searching (`fuzzy-matcher`) are performed by well-regarded libraries. No explicit `eval` or similar dynamic code execution patterns are observed. The system relies on a locally controlled project directory, which is a key security boundary. A point is deducted for the inherent complexity of file system interactions and potential undiscovered vulnerabilities in external dependencies.

Similar Servers

Stats

Interest Score41
Security Score9
Cost ClassMedium
Avg Tokens7500
Stars40
Forks3
Last Update2026-01-18

Tags

Knowledge ManagementMarkdownAI IntegrationCLIDocumentation