Kitbag MCP 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

🚀 Quick Start (Zero Config)

Run instantly using npx (Node.js required):

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:

# Enable PDF and Web scraping modules only
npx kitbag-mcp --enabled-modules pdf,web

➜ ➜ ➜

⚙️ Supported Clients Setup

1. Claude Desktop

Add this entry to your claude_desktop_config.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:

{
  "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.

kitbag-config.json schema:

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

🗺️ Tool Category Index

📚 Complete Tool Directory

📄 PDF Tools (pdf.*)

High-performance local PDF parsers and manipulators.

🌐 Web Scraping & Networking (web.*)

Interact with raw web documents and query networking systems.

📸 Image & OCR Tools (image.*)

Manipulate images and extract text locally.

📊 Data Transformation (data.*)

Fast, offline conversion between standard data formats.

💻 Developer Utilities (developer.*)

Standard formats, validation, and layout tools for developers.

🛠️ Utility Tools (utility.*)

System, network, and cryptography helper functions.

🧠 AI Chunker (ai.*)

Segment large text structures dynamically for ingestion.

🏗️ How It Works

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

Command Guide

# Build compiler output
npm run build

# Run all 50 module tests
npm 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.

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