Kitbag Mcp

io.github.syedtaj7Published by GitHub account syedtaj7v1.1.2Updated Oct 24, 2026

Zero-config MCP server bundling 50+ utility tools: converters, OCR, scraping, and formatters.

VerifiedSTDIODesktop onlyWeb Search & ScrapingFiles & StorageDeveloper Tools

Overview

AI-generated overview

A local MCP server bundling 50+ utility tools for PDF, web, image, data, developer, and general tasks.

What you can do
Kitbag MCP bundles over 50 utility tools in one local server, grouped into modules such as PDF parsing and conversion, web scraping and feeds, image resizing and OCR, data format conversion, developer helpers, and general utilities. Tools include PDF text and table extraction, webpage-to-Markdown conversion, RSS and sitemap parsing, CSV/JSON/XML/YAML conversion, JSON and SQL formatting, JWT decoding, QR generation, hashing, and ZIP creation and extraction. Modules can be selectively enabled to limit which tools are exposed.
When to use it
Useful when you want a single local server for many small, unrelated utility tasks instead of installing several single-purpose MCP servers. It suits document conversion, scraping, data format conversion, and everyday developer formatting or validation work.
Requirements
Runs locally as a stdio process via npx, so Node.js is required. No API keys, accounts, or hosting are needed. Configuration is optional through CLI flags, environment variables such as KITBAG_ENABLED_MODULES, or a kitbag-config.json file.
Before you install
Some tools read and write local files, including merging, splitting, extracting, and creating ZIP archives, so review file paths before use. Web scraping, DNS, SSL, and email validation tools make network requests to third-party sites. No credentials are requested by the server itself.

Installation

In SourceWeft

  1. Open Kitbag Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README


Kitbag MCP is a single, open-source Model Context Protocol server that bundles a curated library of 50+ high-value utility tools — document converters, OCR processors, web scrapers, data formatters, and AI developer utilities — all in one place.

Instead of installing, configuring, and paying to host a dozen single-purpose MCP servers, install Kitbag MCP once and selectively enable only the modules you need. It runs entirely on your machine: zero hosting costs, no API keys, no server setup.

📖 Table of Contents

Click to expand

🚀 Quick Start (Zero Config)

Run instantly using npx (Node.js required):

bash
npx kitbag-mcp

Expose Specific Modules (Saves LLM Context Tokens)

To prevent your AI agents from getting overwhelmed by tool options, enable only what you need:

bash
# Enable PDF and Web scraping modules onlynpx kitbag-mcp --enabled-modules pdf,web

⚙️ Supported Clients Setup

1. Claude Desktop

Add this entry to your claude_desktop_config.json:

json
{  "mcpServers": {    "kitbag-mcp": {      "command": "npx",      "args": [        "-y",        "kitbag-mcp",        "--enabled-modules",        "pdf,web,image,data,utility,ai"      ]    }  }}

2. Cursor

  1. Go to Settings → Beta Features → MCP.
  2. Click + Add New MCP Server.
  3. Configure:
    • Name: Kitbag MCP
    • Type: stdio
    • Command: npx -y kitbag-mcp --enabled-modules pdf,web,data,utility

3. Windsurf

Add this entry to your mcp_config.json:

json
{  "mcpServers": {    "kitbag-mcp": {      "command": "npx",      "args": [        "-y",        "kitbag-mcp"      ],      "env": {        "KITBAG_ENABLED_MODULES": "pdf,web,data,utility"      }    }  }}

🎛️ Configuration Flags & Environment Variables

Kitbag MCP can be configured through CLI flags, environment variables, or a JSON config file — whichever fits your workflow.

Configuration SourceExample Usage
CLI Flags--enabled-modules pdf,web or --enabled-tools utility.qr_generate
Env VariablesKITBAG_ENABLED_MODULES=pdf,web or KITBAG_ENABLED_TOOLS=utility.qr_generate
JSON ConfigA kitbag-config.json file in the current working directory, or via --config /path/to/config.json

kitbag-config.json schema:

json
{  "enabledModules": ["pdf", "web", "image", "data", "utility", "ai", "developer"],  "enabledTools": [],  "defaultTimeoutMs": 30000,  "maxPayloadSizeBytes": 52428800}

🗺️ Tool Category Index

CategoryPrefixToolsFocus
📄 PDFpdf.*6Parsing, conversion, merging, splitting
🌐 Webweb.*7Scraping, feeds, sitemaps, DNS
📸 Image & OCRimage.*5Resizing, compression, OCR, EXIF
📊 Datadata.*8CSV / JSON / XML / YAML conversion
💻 Developerdeveloper.*11Formatting, linting, diffing, decoding
🛠️ Utilityutility.*12Crypto, QR, networking, archives
🧠 AIai.*1Text chunking for LLM ingestion

📚 Complete Tool Directory

📄 PDF Tools (pdf.*)

High-performance local PDF parsers and manipulators.

Tool NameDescriptionExample Agent Prompt
pdf.convert_to_textExtract raw text from a PDF document."Extract the text from reports/invoice.pdf"
pdf.convert_to_markdownParse PDF and format it into clean Markdown."Convert layout of guide.pdf to markdown"
pdf.extract_imagesExtract raw image assets embedded inside a PDF."Extract all images from slide_deck.pdf"
pdf.extract_tablesExtract structured table data from PDF pages."Pull out all tables from financial_report.pdf"
pdf.mergeMerge multiple PDF files together in order."Merge doc1.pdf and doc2.pdf into a single file"
pdf.splitSplit specific page ranges from a PDF."Give me page 1 to 3 from main_guide.pdf"

🌐 Web Scraping & Networking (web.*)

Interact with raw web documents and query networking systems.

Tool NameDescriptionExample Agent Prompt
web.to_markdownScrape a webpage, clean clutter, and convert to Markdown."Convert the article at https://example.com/blog to markdown"
web.extract_metadataExtract title, description, OG tags, and JSON-LD data."Get metadata for URL https://news.ycombinator.com"
web.extract_linksScrape a webpage and list internal and external links."Find all external links on the Wikipedia page for AI"
web.rss_parserParse an RSS or Atom feed XML URL into JSON."Get the latest feed items from https://github.blog/feed/"
web.sitemap_generatorFetch and parse a sitemap.xml URL, extracting all URLs."Fetch all URLs in the sitemap for google.com"
web.dns_lookupPerform DNS resolution (A, AAAA, MX, TXT, etc.)."Do an MX record lookup for domain gmail.com"
web.youtube_transcriptExtract text transcripts and captions with timestamps."Get the transcript for https://www.youtube.com/watch?v=dQw4w9"

📸 Image & OCR Tools (image.*)

Manipulate images and extract text locally.

Tool NameDescriptionExample Agent Prompt
image.ocrExtract text from an image locally using Tesseract OCR."Extract text from screenshot.png"
image.resizeResize an image's dimensions (width and height)."Resize avatar.png to be 200x200 pixels"
image.compressCompress image file size with custom quality."Compress banner.jpg to 80% quality"
image.convert_formatConvert images between formats (PNG, JPEG, WebP, etc.)."Convert logo.png to webp format"
image.exif_metadataExtract EXIF camera and location metadata from image files."Show me the GPS coordinates and camera model of photo.jpg"

📊 Data Transformation (data.*)

Fast, offline conversion between standard data formats.

Tool NameDescriptionExample Agent Prompt
data.csv_to_jsonConvert CSV file or raw text to JSON."Parse users.csv and return it as JSON"
data.json_to_csvConvert JSON array of objects to CSV output."Convert this array of users to a CSV table"
data.xml_to_jsonConvert XML documents to structured JSON objects."Convert this configuration XML text to JSON"
data.json_to_xmlConvert JSON objects to clean XML output."Export this JSON object into XML tag format"
data.yaml_to_jsonConvert YAML documents to JSON."Convert Kubernetes config yaml to JSON"
data.json_to_yamlConvert JSON objects to clean YAML format."Format this database JSON block as YAML"
data.deduplicateDeduplicate arrays of JSON objects by a specific key."Remove duplicates from this list of user objects by ID"
data.diff_arraysCompare two JSON arrays and list differences."Compare array A and B and show me additions and removals"

💻 Developer Utilities (developer.*)

Standard formats, validation, and layout tools for developers.

Tool NameDescriptionExample Agent Prompt
developer.json_formatterFormat and prettify JSON strings with custom indentation."Prettify this JSON string using 4 spaces indent"
developer.jwt_decoderDecode JWT tokens to read payload/header claims."Decode this JWT token: eyJhbGciOiJI..."
developer.sql_formatterFormat SQL strings for multiple database dialects."Format this messy select query for PostgreSQL"
developer.mermaid_generateCreate Mermaid diagrams (flowcharts, sequence, etc.)."Generate a flowchart diagram representing this user flow"
developer.openapi_parserParse and format OpenAPI/Swagger specification files."List the endpoints and request schemas of this openapi.yaml"
developer.regex_testerTest regular expression matches on text."Test if this email regex matches [email protected]"
developer.cron_parserParse Cron expressions and list upcoming execution times."Tell me when the cron job '0 9 * * 1-5' runs next"
developer.diff_filesShow line differences between text files."Show me the diff between fileA.txt and fileB.txt"
developer.diff_jsonShow differences between JSON schemas."Highlight structural changes between config1.json and config2.json"
developer.code_detectorDetect programming language and syntax structure."What programming language is this code written in?"
developer.markdown_lintLint and validate formatting in Markdown files."Find styling errors or trailing spaces in index.md"

🛠️ Utility Tools (utility.*)

System, network, and cryptography helper functions.

Tool NameDescriptionExample Agent Prompt
utility.qr_generateGenerate a QR code as a file or base64 Data URL."Create a QR code pointing to https://github.com"
utility.qr_readRead and decode a QR code from a file or stream."What does the QR code inside code.png say?"
utility.base64_encodeConvert strings/files to base64 format."Base64 encode the string 'Hello World'"
utility.base64_decodeDecode base64 strings back to text."Decode 'SGVsbG8gV29ybGQ='"
utility.uuid_generateGenerate secure UUIDs (v4/v1) or secure passwords."Generate a secure password of length 16"
utility.file_hashCompute md5, sha1, or sha256 hashes of text/data."Calculate the sha256 hash of this string"
utility.email_validateValidate syntax and verify MX records of emails."Check if [email protected] has valid MX records"
utility.ssl_checkQuery certificate expiration date and info for any domain."Check when the SSL certificate for google.com expires"
utility.unit_convertConvert values between physical or data units."Convert 1024 megabytes to gigabytes"
utility.url_parserBreak down URLs into protocol, domain, params, etc."Parse this search query URL into its components"
utility.zip_createCompress files or folders into a single ZIP archive."Compress source/ and assets/ into workspace.zip"
utility.zip_extractExtract a ZIP archive to a destination folder."Extract files from archive.zip into build_dir/"

🧠 AI Chunker (ai.*)

Segment large text structures dynamically for ingestion.

Tool NameDescriptionExample Agent Prompt
ai.text_chunkerChunk long text using paragraph/sentence/word strategies."Chunk this text document into 500-char sizes with a 50-char overlap"

🏗️ How It Works

mermaid
flowchart LR    A[AI Agent / Client] -->|MCP Protocol| B(Kitbag MCP Server)    B --> C{Enabled Modules}    C --> D[📄 pdf.*]    C --> E[🌐 web.*]    C --> F[📸 image.*]    C --> G[📊 data.*]    C --> H[💻 developer.*]    C --> I[🛠️ utility.*]    C --> J[🧠 ai.*]    D & E & F & G & H & I & J --> K[Local Execution<br/>No External API Calls]    K --> A

Kitbag MCP runs as a single local process. Your AI client talks to it over the standard MCP protocol, and only the modules you enable are exposed as tools — keeping token usage low and your workflow fast and private.

🛠️ Local Development & Contributions

Every tool is fully self-contained. Adding a new tool is as simple as creating a folder inside src/tools/<category>/<tool_name>/.

Contribution Requirements

FilePurpose
tool.tsThe main execution code, exporting a ToolDefinition.
README.mdDirect tool documentation and parameter descriptions.
example.jsonSample inputs and expected outputs.
tests.tsSelf-contained unit tests using mocks where necessary to run instantly.

Command Guide

bash
# Build compiler outputnpm run build
# Run all 50 module testsnpm test
# Run real-life execution checks (makes live API and DNS requests)npx tsx src/tests/run_real_life.ts

⚖️ License

Distributed under the MIT License. See LICENSE for more information. Fully open-source and free to adapt for personal or commercial use.

[Image]

⭐ If Kitbag MCP saves you time, consider starring the repo! ⭐

Source: README.md at commit a1c9ce4

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.1.2LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.