This monorepo contains a collection of tools and utilities, many designed to work with the Model Context Protocol (MCP).

The project is structured as a monorepo using pnpm workspaces and managed by Turborepo. It includes various packages providing functionalities ranging from filesystem operations and network requests to data handling (JSON, XML, Base64, PDF) and MCP adaptors.

This repository includes the following packages:

• Core & Adaptors:
  • packages/tools-core: Core utilities and definitions for building tools.
  • packages/tools-adaptor-mcp: Adaptor for integrating tools with MCP servers.
  • packages/tools-adaptor-vercel: Adaptor for Vercel-specific functionalities (if applicable).
• Data Handling:
  • packages/tools-base64 / packages/tools-base64-mcp: Base64 encoding/decoding tools.
  • packages/tools-json / packages/tools-json-mcp: JSON processing tools.
  • packages/tools-xml / packages/tools-xml-mcp: XML processing tools.
  • packages/tools-pdf / packages/tools-pdf-mcp: PDF text extraction tools.
• System & Network:
  • packages/tools-filesystem / packages/tools-filesystem-mcp: Filesystem operations tools.
  • packages/tools-net / packages/tools-net-mcp: Network request tools (fetch, IP info, etc.).
  • packages/tools-hasher / packages/tools-hasher-mcp: Hashing utilities.
• Specialized Tools:
  • packages/tools-rag / packages/tools-rag-mcp: Tools related to Retrieval-Augmented Generation (RAG).
  • packages/tools-wait / packages/tools-wait-mcp: Tools for introducing delays or waiting.
  • packages/tools-fetch-mcp: Specific MCP fetch tool (potentially distinct from tools-net).

(Note: Packages ending with -mcp typically provide the MCP server implementation for the corresponding base tool package.)

• Node.js (Check .nvmrc or package.json engines field if available)
• pnpm (Version specified in package.json's packageManager field)

1. Clone the repository:

   git clone <your-repo-url>
   cd mcp

2. Install dependencies using pnpm:

   pnpm install

To build all packages:

pnpm build

Or build continuously during development:

pnpm build:watch

To check code style and quality using Biome:

pnpm lint

To run tests for all packages (ensure packages are built first):

pnpm test

Contributions are welcome! Please refer to the CONTRIBUTING.md file (if available) for guidelines.

This project is licensed under the ISC License. See the LICENSE file (if available) for details.