Netmex MCP

A lightweight and extendable Model Context Protocol (MCP) server toolkit for building custom tools that integrate with AI assistants.

This package provides a ready-to-use MCP server, a clean structure for defining tools, and the option for developers to add their own tools without modifying the package.

Installation

Or with yarn:

Usage

After installing, you can run the MCP server using:

Creating Custom Tools

To add your own tools, create a tool file inside a mcp-tools/ directory in your project root:

Example Tool (TypeScript)

Using Tools Inside Your Project

Once placed inside mcp-tools/, tools are automatically discovered by the loader and exposed to MCP clients.

No registration needed. No editing package code. Just drop the tool file in place.

Accessing Tool Input

Each tool receives structured arguments, validated according to its inputSchema.

Recommended Directory Layout

NPM Plugin Tools

You can also install tools from npm. Any dependency whose name starts with:

will be auto-loaded by the server.

Example:

Handling Errors

If a tool throws or returns an invalid value, the server automatically returns a JSON-RPC error:

Use try/catch inside handlers for custom error responses.

Built-In Tools

This package includes a few tools by default:

• about

• hello

• (more coming soon)

Development

To build the MCP server locally:

To start it directly:

More About MCP

For more information on the Model Context Protocol, visit the official MCP documentation.

License

This project is licensed under the MIT License.