MCP Custom Tools Server

You run a custom MCP (Model Context Protocol) server that exposes a rich suite of tools for date/time, file handling, system information, text processing, and web operations. Use it to automate tasks, query system data, manipulate text, and perform web requests from any MCP-compatible client connected through stdio. This guide walks you through practical usage, installation steps, and essential configuration so you can start exploring tools right away.

How to use

You interact with the server through an MCP client that communicates over stdio. Start the server using the provided runtime command, then call any of the available tools by name with the appropriate parameters. You can adjust the logging level to DEBUG for troubleshooting or INFO for normal operation. The server is designed to be extended with additional tools, while keeping a robust logging and error handling experience.

How to install

Prerequisites you need before installation are Python 3.10 or newer and a modern package manager for runtime and environment handling.

Install and set up the server with these steps. Run each command on its own line to keep the process clear.

Clone the project repository and move into it.

Install and run steps

# Clone the repository
git clone <repository-url>
cd mcp-custom-tools

# Install uv helper (if not present)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Synchronize/install dependencies locally
uv sync

# Install development dependencies
uv sync --group dev

# Verify installation options
uv run mcp-server --help

Run the server with standard logging or customized config

# Recommended method - run the MCP server directly
uv run mcp-server

# Run with a specific log level
uv run mcp-server --log-level DEBUG

# Run with a customized configuration
uv run mcp-server --log-level INFO --name "Mi Servidor MCP" --version "1.0.0"

# Alternative method - run as a Python module
uv run python -m mcp_custom_tools.server

# Run as a Python module with a custom config
uv run python -m mcp_custom_tools.server --log-level INFO --name "Custom Server"

Configuration notes

You can configure the MCP client connection using stdio. The server supports a local runtime via uv, and you can start it with or without extra flags as shown above.

Troubleshooting tips

If the command to start the MCP server is not recognized on your system, ensure you are using the uv runtime command as shown. On Windows, always invoke via uv run to access the local runtime installed in the environment.

Available tools overview

The server provides a comprehensive collection of tools across categories for everyday tasks. Explore the tools to see inputs, outputs, and how to chain operations for more complex workflows.

Notes on hosting and environment

The server uses asynchronous communication and can operate with stdio, which makes it compatible with any MCP client that supports stdio-based interactions. Logging can be configured to fit debugging or production needs.

Development and extending

To add new tools, implement the tool function, register it with the tool registry, and import it in the tools package. This keeps the server extensible while preserving a consistent interface for MCP clients.

Available tools

datetime_tools.current_time

Return the current date and time.

datetime_tools.format_timestamp

Format a timestamp into a human-readable string.

datetime_tools.calculate_age

Calculate age from a birth date.

datetime_tools.days_between

Compute the number of days between two dates.

datetime_tools.month_calendar

Generate a monthly calendar.

file_tools.read_file

Read file contents asynchronously or synchronously.

file_tools.file_info

Provide detailed information about a file.

file_tools.list_directory

List the contents of a directory.

file_tools.calculate_hash

Compute MD5 or SHA256 hash for a file.

file_tools.search_files

Search for files by pattern.

system_tools.system_info

General system information.

system_tools.cpu_info

Detailed CPU information.

system_tools.memory_info

Memory usage information.

system_tools.disk_info

Disk and storage information.

system_tools.network_info

Network interface information.

system_tools.process_list

List of running processes.

system_tools.environment_vars

System environment variables.

text_tools.word_count

Count words, lines, and characters.

text_tools.search_replace

Regex search and replace.

text_tools.extract_emails

Extract email addresses.

text_tools.extract_urls

Extract URLs from text.

text_tools.text_analysis

Detailed text analysis.

text_tools.encode_decode

Encode and decode text.

text_tools.generate_hash

Generate a hash of text.

text_tools.split_text

Split text into chunks.

web_tools.http_request

Make HTTP requests.

web_tools.parse_url

Parse and analyze URLs.

web_tools.build_url

Construct URLs from components.

web_tools.url_encode_decode

URL encoding and decoding.

web_tools.validate_url

Validate URL format and accessibility.

web_tools.extract_domain

Extract domain information.