@harnyk/various-utils-mcp
v0.1.11
Published
MCP server with various utilities (path_relative)
Readme
MCP Various Utilities Server
This project implements an MCP (Model Context Protocol) server that provides a collection of utility functions accessible as tools and prompts.
Features
Currently, the server offers the following functionalities:
Tools
path_relative: Calculates the relative path from a base file path to a target file path.- Input:
base_file_name(string),target_file_name(string) - Output: The relative path as a string.
- Input:
get_working_directory: Returns the current working directory of the server process.- Input: None
- Output: The current working directory as a string.
parse_junit_xml: Parses a JUnit XML report file to extract detailed test results, including failed tests, slow tests (based on a configurable threshold), and slow suites (based on a percentile).- Input:
junit_xml_path(string),slowTestThresholdSec(number, optional, default: 5),topSlowTests(number, optional, default: 20),slowSuitesQuantile(number, optional, default: 0.8),minKeepSuites(number, optional, default: 1) - Output: A JSON object containing statistics, failed tests, slow tests, and slow suites.
- Input:
Prompts
JunitParse: An interactive prompt designed to assist users in analyzing JUnit XML files. It discovers JUnit XML files within a specified depth, allows the user to select files, and then presents a structured analysis of failures, slow tests, and slow suites.- Input: None (interactive)
- Output: Formatted analysis of JUnit XML reports.
Technologies Used
- TypeScript: For type-safe and maintainable code.
- Node.js: The runtime environment.
@modelcontextprotocol/sdk: The SDK for building MCP servers.fast-glob: For efficient file system globbing.fast-xml-parser: For parsing XML content, specifically JUnit reports.zod: For robust schema validation of tool inputs.
Installation
To install the various-utils-mcp CLI globally, run:
pnpm install -g @harnyk/various-utils-mcpUsage
To start the MCP server, run the installed binary:
various-utils-mcpDevelopment
For development, you can use tsx to run the server directly without building:
npm run devTo run type checks:
npm run typecheck