my-mcp-server is an MCP server that serves as a starter template and boilerplate for developing custom Model Context Protocol servers using the Node.js mcp-framework. It connects custom local tools and API services to LLM clients such as Claude Desktop. Designed for TypeScript and Node.js developers, the project eliminates manual protocol boilerplate by structuring tool definitions with modular TypeScript classes and Zod schema validation. Developers use this template to quickly scaffold custom tooling, manage parameter validation, and build standalone tools that Claude can execute during conversations. The template includes automatic tool loading on startup, command-line helpers to scaffold new tools, and publishing configurations for npm distribution, enabling developers to run custom server logic locally through Node or distribute executable tools via npx across different development workstations.
Category: Other & General Purpose
Tags: boilerplate, framework, nodejs, template
bash npm install 3. Build the TypeScript files: bash npm run build 4. Open your Claude Desktop configuration file (claude_desktop_config.json) and add the server definition under mcpServers pointing to your compiled entry point: json { "mcpServers": { "my-mcp-server": { "command": "node", "args": ["/absolute/path/to/my-mcp-server/dist/index.js"] } } } 5. Alternatively, if published to npm, configure it using npx: json { "mcpServers": { "my-mcp-server": { "command": "npx", "args": ["my-mcp-server"] } } } 6. Restart Claude Desktop to start using your tools.mcp add tool. * Packaging and distributing custom MCP tool collections to public or private npm registries for easy installation. * Running internal development utilities and local API clients directly within supported AI desktop environments.Part of MCP Servers
You can install my-mcp-server by cloning the repository and running npm install. To compile the TypeScript source into executable JavaScript, run npm run build. You then configure the compiled dist/index.js path inside your Claude Desktop configuration file.
my-mcp-server provides a pre-built template for developing Model Context Protocol servers in Node.js. It lets you generate new tools using CLI commands, define parameter schemas with Zod, and expose local TypeScript functions to AI assistants like Claude Desktop.
my-mcp-server works with Claude Desktop on macOS and Windows, as well as any other client application that supports standard Model Context Protocol servers communicating over standard input and output streams via Node.js or npx.
You can generate new tool files by executing mcp add tool followed by your tool name in your terminal. This creates a TypeScript class inheriting from MCPTool where you define input schemas using Zod and implement your execution logic.