mcp-boilerplate-node
by timescale
Overview
This boilerplate provides common code for creating a Model Context Protocol (MCP) server in Node.js, focusing on integrating 'skills' (modular agent capabilities) as tools and resources for LLM agents.
Installation
No command providedEnvironment Variables
- OTEL_SERVICE_NAME
- MCP_ENABLED_TOOLS
- MCP_DISABLED_TOOLS
- MCP_ENABLED_PROMPTS
- MCP_DISABLED_PROMPTS
- MCP_ENABLED_RESOURCES
- MCP_DISABLED_RESOURCES
- SKILLS_TTL
- SKILLS_FILE
- OTEL_EXPORTER_OTLP_ENDPOINT
- JAEGER_TRACES_ENDPOINT
- LOGFIRE_TRACES_ENDPOINT
- LOGFIRE_LOGS_ENDPOINT
- LOGFIRE_TOKEN
- PORT
- INSTRUMENT
- NODE_ENV
- ENABLE_INSPECTOR
- MCP_USE_ANONYMIZED_TELEMETRY
- MCP_PUBLIC_URL
Security Notes
The boilerplate's `apiRouterFactory` directly exposes MCP tools as REST API endpoints without built-in authentication or authorization, which requires careful implementation by the user for sensitive operations. The 'Skills' feature allows loading content from configured GitHub repositories; this introduces a supply chain risk if untrusted or compromised repositories are used. While local file path traversal is mitigated by `normalizeSkillPath`, the inherent trust in external GitHub sources for skill content is a significant consideration. OpenTelemetry integration, while beneficial for observability, could inadvertently expose sensitive data if not configured properly by the implementer.
Similar Servers
mcp-server-starter-ts
A minimal TypeScript starter template for building Model Context Protocol (MCP) servers, enabling AI applications to connect with data sources and tools through a standardized interface.
mcp-sdk-functions-hosting-node
A Node.js server for hosting serverless functions, likely within a Managed Cloud Platform (MCP) SDK context.
generator-app-remote-mcp-server-generic
Provides backend services for a generic multi-cloud application generator, enabling remote application scaffolding and management across various cloud providers.
starter-mcp-server
A starter kit for developing and deploying serverless functions or microservices across multiple cloud providers, exemplified by a chat application.