Skip to main content
Glama
mcp-loader

mcp-loader

MCP Loader

Drop .ts or .js files in a folder. They become MCP tools. That's it.

Quick Start

// .claude/tool/math.ts
import { tool } from "mcp-loader";

export const add = tool({
  description: "Add two numbers",
  args: {
    a: tool.schema.number(),
    b: tool.schema.number(),
  },
  execute: ({ a, b }) => a + b,
});

Add to .mcp.json:

{
  "mcpServers": {
    "tools": {
      "command": "npx",
      "args": ["mcp-loader", ".claude/tool"]
    }
  }
}

Done. Tools work in Claude.

Related MCP server: ts-mcp-meta

Install

Global install:

npm install -g mcp-loader

Or as a dev dependency:

npm install --save-dev mcp-loader

Or just use npx (no install):

npx mcp-loader .claude/tool

Features

  • Hot reload - Save file, tool updates (disable with MCP_NO_HOT_RELOAD=true)

  • Multiple tools per file - Use named exports

  • MCP context - Second param in execute has request info

  • TypeScript - Full type safety

Note

After changing tools, refresh with /mcp in Claude Code or restart Claude Desktop.

License

MIT

Available Tools

16 tools
context-test_contextInfoB

Get detailed information about the MCP context

Inputs: no named parameters.

context-test_trackUsageC

Track tool usage with context information

Inputs: action (required).

context-test_withTimeoutC

Execute something with timeout using AbortSignal from context

Inputs: delayMs (required).

demoD

Demo tool with enum and default value

Inputs: message (required), style, prefix.

math_addA

Add two numbers

Inputs: a (required), b (required).

math_divideC

Divide two numbers

Inputs: a (required), b (required).

math_multiplyA

Multiply two numbers

Inputs: a (required), b (required).

session_infoB

Get information about the current Claude Code session

Inputs: no named parameters.

session_notifyC

Send a notification through MCP

Inputs: message (required), level.

session_requestC

Make a request through MCP protocol

Inputs: method (required).

systemB

Get system information and MCP context

Inputs: no named parameters.

testC

Test tool to verify MCP loader works

Inputs: message.

test_echoA

Echo back a message

Inputs: text (required).

test_getTimeB

Get current UTC time

Inputs: format.

test_hotReloadTestD

Test that hot reload is working

Inputs: name.

test_liveTestC

Live reload test - added without restart

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.4/5.0

    Scored across 16 tools

    Disambiguation2/5

    Several tools overlap in purpose, especially the generic verification tools 'test', 'demo', 'test_hotReloadTest', and 'test_liveTest', which an agent could easily confuse. The context/system information tools also blur together: 'system', 'session_info', and 'context-test_contextInfo' all report similar environment/context details.

    Naming Consistency2/5

    Tool naming is mixed: math_, session_, and test_ prefixes are used, but there are bare names like 'demo', 'system', and 'test' alongside hyphens and camelCase in 'context-test_contextInfo' and 'test_hotReloadTest'. The overall pattern is readable but inconsistent.

    Tool Count3/5

    At 16 tools, the set is borderline heavy for what appears to be a loader/test utility server. Many of the test/demo/verification tools could likely be consolidated without losing functionality.

    Completeness3/5

    The set covers math, session, context, echo, time, and reload-testing scenarios, but it feels like a grab bag rather than a complete domain surface. Notable gaps include no math subtraction, no negative/error-case testing tools, and redundant generic test tools that do not clearly advance the loader-testing purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A hot-reloadable MCP proxy server that enables users to create and manage custom Python tools through dynamic module loading. Users can build their own utilities, wrap APIs, and extend functionality by simply adding Python files to designated folders.
      7
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables building MCP servers in TypeScript where tool schemas, descriptions, and validation are automatically generated from class methods, their TypeScript types, and JSDoc comments at compile time.
      1
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables building and running an MCP server with automatically discovered tools, prompts, and resources over HTTP or STDIO, using TypeScript and Zod schemas.
      -