TypeScript TemplateCAUTION
TypeScript template for building MCP servers
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
A TypeScript template for building remote Model Context Protocol (MCP) servers with modern tooling and best practices while leveraging the MCP TypeScript SDK.
Features
This template provides:
- TypeScript 7 - Native compiler with strict configuration; TypeScript 6 remains available for
typescript-eslint's compiler API - Effect - Typed configuration, validation, logging, error handling, and async workflows
- Vite - Fast build system with ES modules output
- Express - Fast, unopinionated web framework for HTTP server
- ESLint + Prettier - Code quality and formatting
- Docker - Containerization support
- Example Tools -
echoandelicit_echotools demonstrating tool implementation, structured output, annotations, and MCP elicitation
Getting Started
The easiest way to get started is using degit:
- Create a new project from this template
npx degit nickytonline/mcp-typescript-template my-mcp-server cd my-mcp-server
- Install dependencies
npm install
- Build the project
npm run build
- Start the server
npm start
The server will be available at http://localhost:3000 for MCP connections.
Alternative: Using GitHub Template
You can also click the "Use this template" button on GitHub to create a new repository, then clone it:
git clone cd my-mcp-server npm install
Development
Type checking
npm run typecheck uses the TypeScript 7 compiler. The typescript package is an npm alias for the TypeScript 6 compatibility package because typescript-eslint still depends on TypeScript's legacy compiler API; the compatibility package is available as tsc6 when needed.
Watch mode for development (with hot reloading)
npm run dev
Build the project
npm run build
##
5a6dcdf170afOBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add mcp-typescript-template -- npx -y [email protected]
{
"mcpServers": {
"mcp-typescript-template": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Exposed tools (2)
2 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
echo | read | |
elicit_echo | read |
Trust audit
CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (7)
.claude/skills
streamable-http
.commitlintrc.json
.releaserc.json
CLAUDE.md
baseUrl: `http://127.0.0.1:${address.port}`,@modelcontextprotocol/node, @modelcontextprotocol/server, @types/express, effect, express, @commitlint/cli, @commitlint/config-conventional, @modelcontextprotocol/client
Gates applied: no_behavioural_pass.
5a6dcdf170affull audit observations/trust-audit/mcp-server/nickytonline__typescript-template-2.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 5a6dcdf170af | CAUTION | B | 89 | first audit |
Questions
What is the TypeScript Template MCP server?
TypeScript template for building MCP servers
What tools does TypeScript Template expose?
2 in total: 2 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is TypeScript Template safe to connect to an agent?
With care. The audit graded it B (89/100) and found 7 things worth knowing before you trust this server, listed below with the exact line each was found on.
What credentials does TypeScript Template need?
No credential environment variables were found in its source, so it appears to need none.
How does TypeScript Template run?
It speaks streamable-http, so it runs as a service you connect to over the network. It is published on npm as mcp-typescript-template at 1.0.0.
How current is this page?
The grade is for one exact copy of the source (5a6dcdf170af), read on 2026-10-08. The repository is watched and re-audited when it changes.