Back to Home
timescale icon

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

Run Command
No command provided

Environment 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

Stats

Interest Score31
Security Score6
Cost ClassMedium
Avg Tokens1000
Stars4
Forks0
Last Update2026-01-07

Tags

Node.jsMCPLLM AgentsBoilerplateSkills