@tigerdata/mcp-boilerplate 0.1.9 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +2 -0
- package/dist/index.js +2 -0
- package/dist/mcpServer.js +47 -37
- package/package.json +12 -8
package/dist/index.d.ts
CHANGED
|
@@ -5,3 +5,5 @@ export { stdioServerFactory } from './stdio.js';
|
|
|
5
5
|
export { type ApiFactory } from './types.js';
|
|
6
6
|
export { StatusError } from './StatusError.js';
|
|
7
7
|
export { type AdditionalSetupArgs } from './mcpServer.js';
|
|
8
|
+
export { withSpan, addAiResultToSpan } from './tracing.js';
|
|
9
|
+
export { registerExitHandlers } from './registerExitHandlers.js';
|
package/dist/index.js
CHANGED
|
@@ -3,3 +3,5 @@ export { httpServerFactory } from './httpServer.js';
|
|
|
3
3
|
export { log } from './logger.js';
|
|
4
4
|
export { stdioServerFactory } from './stdio.js';
|
|
5
5
|
export { StatusError } from './StatusError.js';
|
|
6
|
+
export { withSpan, addAiResultToSpan } from './tracing.js';
|
|
7
|
+
export { registerExitHandlers } from './registerExitHandlers.js';
|
package/dist/mcpServer.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
|
-
import { SpanStatusCode, trace } from '@opentelemetry/api';
|
|
2
|
+
import { SpanStatusCode, trace, context as otelContext, propagation, SpanKind, } from '@opentelemetry/api';
|
|
3
3
|
import { log } from './logger.js';
|
|
4
4
|
const name = process.env.OTEL_SERVICE_NAME;
|
|
5
5
|
const tracer = trace.getTracer(name ? `${name}.mcpServer` : 'mcpServer');
|
|
@@ -39,44 +39,54 @@ export const mcpServerFactory = ({ name, version = '1.0.0', context, apiFactorie
|
|
|
39
39
|
// make sense.
|
|
40
40
|
title: tool.config.title,
|
|
41
41
|
},
|
|
42
|
-
}, async (args
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
return {
|
|
50
|
-
content: [
|
|
51
|
-
{
|
|
52
|
-
type: 'text',
|
|
53
|
-
text,
|
|
54
|
-
},
|
|
55
|
-
],
|
|
56
|
-
structuredContent: result,
|
|
57
|
-
};
|
|
58
|
-
}
|
|
59
|
-
catch (error) {
|
|
60
|
-
log.error('Error invoking tool:', error);
|
|
61
|
-
span.recordException(error);
|
|
62
|
-
span.setStatus({
|
|
63
|
-
code: SpanStatusCode.ERROR,
|
|
64
|
-
message: error.message,
|
|
42
|
+
}, async (args, extra) => {
|
|
43
|
+
let traceContext = otelContext.active();
|
|
44
|
+
if (extra?._meta?.traceparent) {
|
|
45
|
+
// Some MCP clients (e.g. pydantic) pass the parent trace context
|
|
46
|
+
traceContext = propagation.extract(traceContext, {
|
|
47
|
+
traceparent: extra._meta.traceparent,
|
|
48
|
+
tracestate: extra._meta.tracestate,
|
|
65
49
|
});
|
|
66
|
-
return {
|
|
67
|
-
content: [
|
|
68
|
-
{
|
|
69
|
-
type: 'text',
|
|
70
|
-
text: `Error: ${error.message || 'Unknown error'}`,
|
|
71
|
-
},
|
|
72
|
-
],
|
|
73
|
-
isError: true,
|
|
74
|
-
};
|
|
75
|
-
}
|
|
76
|
-
finally {
|
|
77
|
-
span.end();
|
|
78
50
|
}
|
|
79
|
-
|
|
51
|
+
return tracer.startActiveSpan(`mcp.tool.${tool.name}`, { kind: SpanKind.SERVER }, traceContext, async (span) => {
|
|
52
|
+
span.setAttribute('mcp.tool.args', JSON.stringify(args));
|
|
53
|
+
try {
|
|
54
|
+
const result = await tool.fn(args);
|
|
55
|
+
const text = JSON.stringify(result);
|
|
56
|
+
span.setAttribute('mcp.tool.responseBytes', text.length);
|
|
57
|
+
span.setStatus({ code: SpanStatusCode.OK });
|
|
58
|
+
return {
|
|
59
|
+
content: [
|
|
60
|
+
{
|
|
61
|
+
type: 'text',
|
|
62
|
+
text,
|
|
63
|
+
},
|
|
64
|
+
],
|
|
65
|
+
structuredContent: result,
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
catch (error) {
|
|
69
|
+
log.error('Error invoking tool:', error);
|
|
70
|
+
span.recordException(error);
|
|
71
|
+
span.setStatus({
|
|
72
|
+
code: SpanStatusCode.ERROR,
|
|
73
|
+
message: error.message,
|
|
74
|
+
});
|
|
75
|
+
return {
|
|
76
|
+
content: [
|
|
77
|
+
{
|
|
78
|
+
type: 'text',
|
|
79
|
+
text: `Error: ${error.message || 'Unknown error'}`,
|
|
80
|
+
},
|
|
81
|
+
],
|
|
82
|
+
isError: true,
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
finally {
|
|
86
|
+
span.end();
|
|
87
|
+
}
|
|
88
|
+
});
|
|
89
|
+
});
|
|
80
90
|
}
|
|
81
91
|
for (const factory of promptFactories) {
|
|
82
92
|
const prompt = factory(context);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tigerdata/mcp-boilerplate",
|
|
3
|
-
"version": "0.1
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "MCP boilerplate code for Node.js",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "TigerData",
|
|
@@ -16,6 +16,10 @@
|
|
|
16
16
|
".": {
|
|
17
17
|
"import": "./dist/index.js",
|
|
18
18
|
"types": "./dist/index.d.ts"
|
|
19
|
+
},
|
|
20
|
+
"./instrumentation": {
|
|
21
|
+
"import": "./dist/instrumentation.js",
|
|
22
|
+
"types": "./dist/instrumentation.d.ts"
|
|
19
23
|
}
|
|
20
24
|
},
|
|
21
25
|
"files": [
|
|
@@ -29,14 +33,14 @@
|
|
|
29
33
|
"lint:fix": "eslint --fix"
|
|
30
34
|
},
|
|
31
35
|
"dependencies": {
|
|
32
|
-
"@modelcontextprotocol/sdk": "^1.
|
|
36
|
+
"@modelcontextprotocol/sdk": "^1.20.1",
|
|
33
37
|
"@opentelemetry/api": "^1.9.0",
|
|
34
|
-
"@opentelemetry/auto-instrumentations-node": "^0.
|
|
35
|
-
"@opentelemetry/exporter-trace-otlp-grpc": "^0.
|
|
36
|
-
"@opentelemetry/instrumentation-http": "^0.
|
|
37
|
-
"@opentelemetry/sdk-metrics": "^2.0
|
|
38
|
-
"@opentelemetry/sdk-node": "^0.
|
|
39
|
-
"@opentelemetry/sdk-trace-node": "^2.0
|
|
38
|
+
"@opentelemetry/auto-instrumentations-node": "^0.66.0",
|
|
39
|
+
"@opentelemetry/exporter-trace-otlp-grpc": "^0.207.0",
|
|
40
|
+
"@opentelemetry/instrumentation-http": "^0.207.0",
|
|
41
|
+
"@opentelemetry/sdk-metrics": "^2.2.0",
|
|
42
|
+
"@opentelemetry/sdk-node": "^0.207.0",
|
|
43
|
+
"@opentelemetry/sdk-trace-node": "^2.2.0",
|
|
40
44
|
"express": "^5.1.0",
|
|
41
45
|
"raw-body": "^3.0.1",
|
|
42
46
|
"zod": "^3.23.8"
|