feat(mcp): add mcp official sdk instrumentation

packages/ai-semantic-conventions/src/SemanticAttributes.ts

@@ -60,6 +60,10 @@ export const SpanAttributes = {
   TRACELOOP_ASSOCIATION_PROPERTIES: "traceloop.association.properties",
   TRACELOOP_ENTITY_INPUT: "traceloop.entity.input",
   TRACELOOP_ENTITY_OUTPUT: "traceloop.entity.output",
+
+  // MCP (Model Context Protocol)
+  MCP_RESPONSE_VALUE: "mcp.response.value",
+  MCP_REQUEST_ID: "mcp.request.id",
 };
 
 export const Events = {
@@ -117,5 +121,6 @@ export enum TraceloopSpanKindValues {
   TASK = "task",
   AGENT = "agent",
   TOOL = "tool",
+  SESSION = "session",
   UNKNOWN = "unknown",
 }

packages/instrumentation-mcp/.prettierignore

@@ -0,0 +1,2 @@
+dist
+node_modules

packages/instrumentation-mcp/README.md

@@ -0,0 +1,67 @@
+# OpenTelemetry MCP Instrumentation for Node.js
+
+[![NPM Published Version][npm-img]][npm-url]
+[![Apache License][license-image]][license-image]
+
+This library allows tracing of agentic workflows implemented with MCP (Model Context Protocol) framework using the [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk).
+
+## Installation
+
+```bash
+npm install --save @traceloop/instrumentation-mcp
+```
+
+## Usage
+
+```javascript
+const { McpInstrumentation } = require("@traceloop/instrumentation-mcp");
+const { registerInstrumentations } = require("@opentelemetry/instrumentation");
+
+registerInstrumentations({
+  instrumentations: [new McpInstrumentation()],
+});
+```
+
+## Privacy
+
+By default, this instrumentation logs prompts, completions, and embeddings to span attributes. This gives you a clear visibility into how your LLM application is working, and can make it easy to debug and evaluate the quality of the outputs.
+
+However, you may want to disable this logging for privacy reasons, as they may contain highly sensitive data from your users. You may also want to disable this logging to reduce the size of your traces.
+
+To disable logging, set the `traceContent` config option to `false`:
+
+```javascript
+const { McpInstrumentation } = require("@traceloop/instrumentation-mcp");
+
+const mcpInstrumentation = new McpInstrumentation({
+  traceContent: false,
+});
+```
+
+## Instrumented Operations
+
+This instrumentation tracks the following MCP operations:
+
+### Client Operations
+
+- Session lifecycle management
+- Tool invocations
+- Resource access
+- Prompt templates
+- MCP protocol methods
+
+### Server Operations
+
+- Request handling
+- Tool execution
+- Resource serving
+- Server-side spans
+
+## License
+
+Apache 2.0 - See [LICENSE][license-url] for more information.
+
+[npm-url]: https://www.npmjs.com/package/@traceloop/instrumentation-mcp
+[npm-img]: https://badge.fury.io/js/%40traceloop%2Finstrumentation-mcp.svg
+[license-url]: https://github.com/traceloop/openllmetry-js/blob/main/LICENSE
+[license-image]: https://img.shields.io/badge/license-Apache_2.0-green.svg?style=flat

packages/instrumentation-mcp/eslint.config.cjs

@@ -0,0 +1,29 @@
+const js = require("@eslint/js");
+const rootConfig = require("../../eslint.config.cjs");
+
+const { FlatCompat } = require("@eslint/eslintrc");
+
+const compat = new FlatCompat({
+  baseDirectory: __dirname,
+  recommendedConfig: js.configs.recommended,
+  allConfig: js.configs.all,
+});
+
+module.exports = [
+  {
+    ignores: ["!**/*", "**/node_modules", "dist/**/*"],
+  },
+  ...rootConfig,
+  {
+    files: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"],
+    rules: {},
+  },
+  {
+    files: ["**/*.ts", "**/*.tsx"],
+    rules: {},
+  },
+  {
+    files: ["**/*.js", "**/*.jsx"],
+    rules: {},
+  },
+];

packages/instrumentation-mcp/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@traceloop/instrumentation-mcp",
+  "version": "0.20.0",
+  "description": "MCP (Model Context Protocol) Instrumentation",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "repository": "traceloop/openllmetry-js",
+  "scripts": {
+    "build": "rollup -c",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "ts-mocha -p tsconfig.json 'test/**/*.test.ts'"
+  },
+  "keywords": [
+    "opentelemetry",
+    "nodejs",
+    "tracing",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "author": "Traceloop",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=14"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.mjs",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "doc",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/core": "^2.0.1",
+    "@opentelemetry/instrumentation": "^0.203.0",
+    "@opentelemetry/semantic-conventions": "^1.36.0",
+    "@traceloop/ai-semantic-conventions": "workspace:*",
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@opentelemetry/context-async-hooks": "^2.0.1",
+    "@opentelemetry/sdk-trace-node": "^2.0.1",
+    "@pollyjs/adapter-fetch": "^6.0.7",
+    "@pollyjs/adapter-node-http": "^6.0.6",
+    "@pollyjs/core": "^6.0.6",
+    "@pollyjs/persister-fs": "^6.0.6",
+    "@types/mocha": "^10.0.10",
+    "ts-mocha": "^11.1.0",
+    "zod": "^3.25.76"
+  },
+  "homepage": "https://github.com/traceloop/openllmetry-js/tree/main/packages/instrumentation-mcp"
+}

packages/instrumentation-mcp/rollup.config.js

@@ -0,0 +1,39 @@
+const dts = require("rollup-plugin-dts");
+const typescript = require("@rollup/plugin-typescript");
+const json = require("@rollup/plugin-json");
+
+const name = require("./package.json").main.replace(/\.js$/, "");
+
+const bundle = (config) => ({
+  ...config,
+  input: "src/index.ts",
+  external: (id) => !/^[./]/.test(id),
+});
+
+exports.default = [
+  bundle({
+    plugins: [
+      typescript.default({ exclude: ["test/**/*", "tests/**/*"] }),
+      json.default(),
+    ],
+    output: [
+      {
+        file: `${name}.js`,
+        format: "cjs",
+        sourcemap: true,
+      },
+      {
+        file: `${name}.mjs`,
+        format: "es",
+        sourcemap: true,
+      },
+    ],
+  }),
+  bundle({
+    plugins: [dts.default({ exclude: ["test/**/*", "tests/**/*"] })],
+    output: {
+      file: `${name}.d.ts`,
+      format: "es",
+    },
+  }),
+];

packages/instrumentation-mcp/src/index.ts

@@ -0,0 +1,18 @@
+/*
+ * Copyright Traceloop
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+export { McpInstrumentation } from "./instrumentation";
+export { McpInstrumentationConfig } from "./types";