mcp-boilerplate
Click on "Deploy 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-boilerplate fetch the URL https://example.com"
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 Template Boilerplate
Production-ready MCP server starter with TypeScript, realistic examples, and Claude Desktop integration.
A production-ready boilerplate for building Model Context Protocol (MCP) servers using TypeScript and Node.js.
Features
TypeScript pre-configured for modern module resolution (
NodeNext)tsupconfigured for lightning-fast buildsClean MCP SDK setup using
StdioServerTransportExample Tool (
web_fetch) — fetches URLs and returns content as a resourceExample Resource (
file://read) — reads local files securelyClaude Desktop integration guide
Quick Start
Installation
git clone https://github.com/agiulucom42-del/mcp-boilerplate.git
cd mcp-boilerplate
npm install
npm run buildRun the server
npm startMCP servers using stdio communicate via standard input/output. npm start waits for JSON-RPC messages from an MCP client.
Integration with Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"my-server": {
"command": "node",
"args": ["/absolute/path/to/mcp-boilerplate/dist/index.js"]
}
}
}Example Tool: web_fetch
The boilerplate ships with a realistic tool that fetches a URL and returns its content:
server.setRequestHandler(CallToolRequestSchema, async (request) => {
if (request.params.name === "web_fetch") {
const url = String(request.params.arguments?.url);
const response = await fetch(url);
const text = await response.text();
return {
content: [{ type: "text", text: text.slice(0, 10000) }]
};
}
throw new Error("Tool not found");
});Example Resource: file://read
Safely read files from an allowed directory:
server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
const path = request.params.uri.replace("file://", "");
const content = await fs.readFile(path, "utf-8");
return {
contents: [{ uri: request.params.uri, text: content }]
};
});How to Customize
Add Tools: Edit the
CallToolRequestSchemahandler insrc/index.tsAdd Resources: Edit
ReadResourceRequestSchemaandListResourcesRequestSchemaChange Name: Update the
nameinnew Server()instantiation
🚀 HUQAN Ecosystem
mcp-boilerplate is part of the HUQAN trust infrastructure for AI. Sister projects:
Tool | What it does |
🔴 Stop leaking API keys | |
📊 Score your README quality | |
🛡️ Scan repo before giving to agent | |
📏 Block PR scope creep | |
🔍 Compare LLM outputs | |
💰 Track LLM API costs | |
✅ Validate LLM JSON outputs | |
🧩 MCP server starter You are here |
License
MIT © HUQAN
Available Tools
1 toolcalculate_sumA
Calculates the sum of two numbers.
Inputs: a (required), b (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity between tools.
The single tool uses a consistent verb_noun pattern (calculate_sum), which is clear and predictable.
A single trivial tool is an extreme mismatch for a functional server, even if it is a boilerplate example.
The server only offers a sum operation, lacking any other arithmetic operations, making it severely incomplete for basic math tasks.
Maintenance
Related MCP Connectors
A simple Typescript MCP server built using the official MCP Typescript SDK and smithery/cli. This…
A TypeScript MCP server for Home Assistant, enabling programmatic management of entities, automati…
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.