Installation

Install @sedata-ai/mcp and verify your environment.

Requirements

Requirement	Version
Node.js	>= 22.16
@modelcontextprotocol/sdk	>= 1.21.1 (peer dependency)
TypeScript	>= 5.0 (recommended for typed configs)

The package targets ESM and CommonJS via dist/index.js with type declarations in dist/index.d.ts.

Install

npm

npm install @sedata-ai/mcp

If you don’t already have the MCP SDK and Zod (used for input schemas), install them too:

npm install @modelcontextprotocol/sdk zod

Bundled OpenTelemetry dependencies

@sedata-ai/mcp brings the OTel pieces it needs as direct dependencies — you don’t have to install or pin them yourself:

Package	Purpose
@opentelemetry/api	Tracer / meter handles
@opentelemetry/sdk-node	Node SDK that wires everything together
@opentelemetry/sdk-trace-base	Trace primitives + samplers
@opentelemetry/sdk-metrics	Periodic metric reader
@opentelemetry/exporter-trace-otlp-http	OTLP/HTTP trace exporter
@opentelemetry/exporter-metrics-otlp-http	OTLP/HTTP metric exporter
@opentelemetry/exporter-trace-otlp-grpc	OTLP/gRPC trace exporter (opt-in)
@opentelemetry/auto-instrumentations-node	Node auto-instrumentations
@opentelemetry/resources	Resource detection (env, host, OS)
@opentelemetry/semantic-conventions	Standard attribute keys

If your project already depends on a different version of @opentelemetry/api, use a single version across the dependency tree. Multiple versions of the API lead to “no-op” tracers that silently drop spans.

Verify the install

Run a one-off script to confirm everything resolves:

verify.ts

import { instrumentServer } from '@sedata-ai/mcp'

console.log(typeof instrumentServer === 'function' ? 'ok' : 'missing')

npx ts-node verify.ts
# → ok

Next

Quickstart

Wire up your first instrumented MCP server.