What is MCP Tools Monorepo

The MCP Tools Monorepo project is a monorepo designed for the Sylph Lab Model Context Protocol (MCP), containing a collection of utilities and packages that facilitate various operations related to MCP servers.

Use cases

Use cases include building applications that require data encoding/decoding, processing various data formats, performing network requests, and implementing functionalities specific to MCP servers.

How to use

To use the MCP Tools Monorepo, developers can install the necessary packages via pnpm and integrate them into their projects. Each package provides specific functionalities, which can be utilized according to the project’s requirements.

Key features

Key features include core utilities for building tools, adaptors for integrating with MCP servers, data handling capabilities for JSON, XML, Base64, and PDF, as well as system and network operation tools.

Where to use

These MCP Tools Monorepo can be used in software development environments, particularly in projects that require interaction with MCP servers, data processing, and network operations.

MCP Tools Monorepo

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

Overview

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.

Packages

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.)

Getting Started

Prerequisites

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

Installation

1. Clone the repository:

   git clone <your-repo-url>
   cd mcp
   

2. Install dependencies using pnpm:

   pnpm install
   

Development

Building Packages

To build all packages:

pnpm build

Or build continuously during development:

pnpm build:watch

Linting

To check code style and quality using Biome:

pnpm lint

Testing

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

pnpm test

Contributing

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

License

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