Kitbag Mcp

io.github.syedtaj7由 GitHub 账号 syedtaj7 发布v1.1.2更新于 Oct 24, 2026

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

已验证STDIO仅桌面网页搜索与抓取文件与存储开发者工具

概览

AI 生成的概览

一个本地 MCP 服务器，内置 50 多个实用工具，涵盖 PDF、网页、图像、数据、开发者及通用任务。

可以做什么
Kitbag MCP 在单个本地服务器中内置 50 多个实用工具，按模块分组，包括 PDF 解析与转换、网页抓取与订阅源、图像缩放与 OCR、数据格式转换、开发者辅助工具以及通用工具。工具涵盖 PDF 文本与表格提取、网页转 Markdown、RSS 与站点地图解析、CSV/JSON/XML/YAML 转换、JSON 与 SQL 格式化、JWT 解码、二维码生成、哈希计算以及 ZIP 创建与解压。可按需启用模块，以限制对外暴露的工具。
适用场景
适合希望用一个本地服务器处理许多零散小工具任务的场景，而不必安装多个单一用途的 MCP 服务器。适用于文档转换、网页抓取、数据格式转换以及日常开发者格式化或校验工作。
运行要求
通过 npx 以 stdio 进程在本地运行，需要 Node.js。无需 API 密钥、账号或托管服务。配置可选，可通过命令行参数、KITBAG_ENABLED_MODULES 等环境变量或 kitbag-config.json 文件完成。
安装前请注意
部分工具会读写本地文件，包括合并、拆分、提取以及创建 ZIP 压缩包，使用前请确认文件路径。网页抓取、DNS、SSL 和邮箱验证工具会向第三方网站发起网络请求。服务器本身不要求提供任何凭据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Kitbag Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 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

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.

[图片]

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

来源：README.md，提交 a1c9ce4

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.1.2最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。