mcp-server-modular
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-modularrun the shell command 'date'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-server-modularNo-code tool loading for MCP. Drop a .js file in the tools/ directory, restart the server, and your tool is live. No server code changes needed.## Quick Start```bash
git clone https://github.com/itamos-technologia/mcp-server-modular.git
cd mcp-server-modular
npm install
node server.js
Server starts on `http://localhost:3100/mcp`. Connect any MCP client to this URL.## Creating a ToolCreate a `.js` file in `tools/` that exports:javascript
import { z } from 'zod';export default {
name: 'my_tool',
description: 'What this tool does.', schema: {
input: z.string().describe('The input parameter'),
verbose: z.boolean().optional().describe('Show extra detail'),
}, async handler({ input, verbose = false }, ctx) {
// Your logic here
// ctx.run(cmd) — execute shell command
// ctx.runSafe(bin, args) — execute without shell (no injection risk)
// ctx.esc(str) — escape string for shell return {
content: [{ type: 'text', text: Result: ${input} }]
};
},
};
|-------|------|----------|-------------|
| `name` | `string` | Yes | Unique tool name |
| `description` | `string` | No | Shown to the LLM |
| `schema` | `object` | Yes | Zod schema for parameters |
| `handler` | `async function` | Yes | Receives `(args, ctx)` |### Handler Context (`ctx`)| Method | Description |
|--------|-------------|
| `ctx.run(cmd, timeout?)` | Execute shell command (returns stdout) |
| `ctx.runSafe(bin, args, timeout?)` | Execute without shell — no injection possible |
| `ctx.esc(str)` | Escape string for safe shell interpolation |### Handler ReturnReturn an MCP content array:```javascript
return {
content: [
{ type: 'text', text: 'Your result here' }
]
};
```## Configuration| Env Variable | Default | Description |
|-------------|---------|-------------|
| `MCP_PORT` | `3100` | Server port |## Example Tools- `tools/hello.js` — Simple greeting (template for new tools)
- `tools/run_command.js` — Shell command execution## Architecture```
server.js — MCP transport + tool discovery
tools/ — Drop tools here
hello.js — Example tool
run_command.js — Example tool
your_tool.js — Your custom tool
```The server scans `tools/` on startup, validates each file exports `name`, `schema`, and `handler`, and registers them with the MCP server. Schema validation is handled by Zod — invalid parameters are rejected before reaching your handler.## More from Itamos
`mcp-server-modular` is the free, open-source foundation.
**[MCP Basic](https://itamos-technologia.com)** — the full production toolkit built on top:
- 📄 **Segment-based file editing** — read and edit code at 5× token savings with built-in verification
- 🌐 **Web page skeletonizer** — browse any page at up to 89% token compression
- 📧 **Universal mail client** — IMAP/SMTP with auto-detect for Gmail, Outlook, Yahoo, and more
- 📋 **Text offloader** — large pastes compressed to skeleton references (34× savings)
- 🧠 **Memory injection** — semantic search across conversation history, injected automatically
- 📊 **Token tracking dashboard** — per-tool breakdown, lifetime savings, cost avoided
**20M+ tokens saved and counting.**
→ [itamos-technologia.com](https://itamos-technologia.com)Apache 2.0 — see [LICENSE](LICENSE)## Author[Itamos Technologia](https://itamos-technologia.com)This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/itamos-technologia/mcp-server-modular'
If you have feedback or need assistance with the MCP directory API, please join our Discord server