Installation
pnpm add @shinzolabs/instrumentation-mcp
Power your agent
Lệnh của chính nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
npx -y @shinzolabs/[email protected]Claude Code không có liên kết cài đặt cho lệnh cục bộ. Sao chép lệnh bên dưới và chạy trong terminal.
claude mcp add shinzo-labs-shinzo-ts -- npx -y @shinzolabs/instrumentation-mcp@1.1.0Chạy trong terminal.
{ "mcpServers": { "shinzo-labs-shinzo-ts": { "command": "npx", "args": [ "-y", "@shinzolabs/[email protected]" ] } }}claude_desktop_config.json
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
MởTừ nhà phát hành
pnpm add @shinzolabs/instrumentation-mcp
TypeScript SDK for MCP server observability, built on OpenTelemetry. Gain insight into agent usage patterns, contextualize tool calls, and analyze server performance across platforms. Integrate with any OpenTelemetry ingest service including the Shinzo platform.
For the simplest configuration, just pass in the server name, version, and exporter endpoint:
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"
import { instrumentServer, TelemetryConfig } from "@shinzolabs/instrumentation-mcp"
const NAME = "my-mcp-server"
const VERSION = "1.0.0"
const server = new McpServer({
name: NAME,
version: VERSION,
description: "Example MCP server with telemetry"
})
// Use TelemetryConfig to set configuration options
const telemetryConfig: TelemetryConfig = {
serverName: NAME,
serverVersion: VERSION,
exporterEndpoint: "http://localhost:4318/v1" // OpenTelemetry collector endpoint - /trace and /metrics are added automatically
}
// Initialize telemetry
const telemetry = instrumentServer(server, telemetryConfig)
// Add tools using the tool method
server.tool(...)
The TelemetryConfig exposes a number of other options for precise and expansive telemetry processing:
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"
import { instrumentServer, TelemetryConfig } from "@shinzolabs/instrumentation-mcp"
const NAME = "my-other-mcp-server"
const VERSION = "1.0.0"
const server = new McpServer({
name: NAME,
version: VERSION,
description: "Example MCP server with telemetry"
})
const telemetryConfig: TelemetryConfig = {
serviceName: NAME,
serviceVersion: VERSION,
exporterEndpoint: "http://localhost:4318/v1", // OpenTelemetry collector endpoint
exporterAuth: {
type: "bearer",
token: process.env.OTEL_AUTH_TOKEN
},
enablePIISanitization: false,
enableTracing: false,
samplingRate: 0.7,
dataProcessors: [
(telemetryData: any) => {
if (telemetryData['mcp.tool.name'] === "sensitive_operation") {
for (const key of Object.keys(telemetryData)) {
if (key.startsWith('mcp.request.argument')) delete telemetryData[key]
}
}
return telemetryData
}
]
}
const telemetry = instrumentServer(server, telemetryConfig)
// Add tools using the tool method
server.tool(...)
The TelemetryConfig interface provides comprehensive configuration options for customizing telemetry behavior:
The exporterAuth property supports multiple authentication methods:
const telemetryConfig: TelemetryConfig = {
serverName: "my-server",
serverVersion: "1.0.0",
exporterEndpoint: "http://localhost:4318/v1" // OpenTelemetry collector endpoint
}
const telemetryConfig: TelemetryConfig = {
serverName: "my-server",
serverVersion: "1.0.0",
exporterEndpoint: "https://api.example.com/v1",
exporterAuth: {
type: "bearer",
token: process.env.OTEL_AUTH_TOKEN
}
}
const telemetryConfig: TelemetryConfig = {
serverName: "my-server",
serverVersion: "1.0.0",
exporterEndpoint: "http://localhost:4318/v1", // OpenTelemetry collector endpoint
dataProcessors: [
(data) => {
// Remove sensitive parameters
if (data['mcp.tool.name'] === 'sensitive_tool') {
delete data['mcp.request.argument.password']
}
return data
}
]
}
const telemetryConfig: TelemetryConfig = {
serverName: "my-server",
serverVersion: "1.0.0",
exporterType: "console",
enableMetrics: false, // Console exporter doesn't support metrics
samplingRate: 1.0 // Sample all traces in development
}
Contributions are welcome! Please see the Contributing Guide in the main repository.
This package is distributed under the MIT License.
TypeScript SDK for MCP server observability, built on OpenTelemetry. Gain insight into agent usage patterns, contextualize tool calls, and analyze server performance across platforms. Integrate with a
{ "mcpServers": { "shinzo-labs-shinzo-ts": { "command": "npx", "args": [ "-y", "@shinzolabs/[email protected]" ] } }}Tổng quan
TypeScript SDK for MCP server observability, built on OpenTelemetry. Gain insight into agent usage patterns, contextualize tool calls, and analyze server performance across platforms. Integrate with any OpenTelemetry ingest service including the Shinzo platform.
Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
Shinzo Ts chạy cục bộ qua stdio.
Kiểm tra lần cuối: 2026-10-27. TypeScript SDK for MCP server observability, built on OpenTelemetry. Gain insight into agent usage patterns, contextualize tool calls, and analyze server performance across platforms. Integrate with any OpenTelemetry ingest service including the Shinzo platform.