@skeletiq/mcp 0.7.0 → 0.7.2

package/README.md

@@ -56,6 +56,8 @@ Run `npx -y @skeletiq/mcp` over stdio with `SKELETIQ_API_KEY` in the environment
 | `SKELETIQ_API_KEY` | yes | — | A personal API token, starting `skq_`. Not a browser session token. |
 | `SKELETIQ_API_URL` | no | `https://api.skeletiq.com` | For self-hosted installs. A trailing `/api/v1` is accepted and trimmed. |
 
+Every request carries a User-Agent of the form `skeletiq-mcp/<version> (<host name>/<host version>)`, naming the MCP host that launched the server.
+
 ## Scopes
 
 A token grants only what you tick. The server's tools need:

package/dist/index.js

@@ -5,7 +5,7 @@ import { serveStdio } from "@modelcontextprotocol/server/stdio";
 
 // src/config.ts
 var SERVER_NAME = "skeletiq";
-var SERVER_VERSION = "0.7.0";
+var SERVER_VERSION = "0.7.2";
 var AGENT_SCHEMA_VERSION = 2;
 function schemaNote(serverVersion) {
   if (serverVersion === void 0 || serverVersion <= AGENT_SCHEMA_VERSION) return null;
@@ -43,7 +43,7 @@ function normalizeApiUrl(raw) {
 }
 
 // src/server.ts
-import { McpServer } from "@modelcontextprotocol/server";
+import { CLIENT_INFO_META_KEY, McpServer } from "@modelcontextprotocol/server";
 
 // src/http/errors.ts
 var SkeletiqApiError = class extends Error {
@@ -199,12 +199,28 @@ function describeApiError(error) {
 
 // src/http/client.ts
 var API_PREFIX = "/api/v1";
+var HOST_TOKEN_MAX = 64;
+function hostToken(value) {
+  return value.replace(/[^A-Za-z0-9._~+-]/g, "-").slice(0, HOST_TOKEN_MAX);
+}
+function userAgent(host) {
+  const base = `${SERVER_NAME}-mcp/${SERVER_VERSION}`;
+  const name = hostToken(host?.name ?? "");
+  if (!name) return base;
+  const version = hostToken(host?.version ?? "");
+  return version ? `${base} (${name}/${version})` : `${base} (${name})`;
+}
 var READ_TIMEOUT_MS = 6e5;
 var SkeletiqClient = class {
   config;
+  hostSource;
   constructor(config) {
     this.config = config;
   }
+  /** Where to read the connected host's name and version from, for the User-Agent. */
+  setHostSource(source) {
+    this.hostSource = source;
+  }
   /** A parsed JSON response, or a thrown `SkeletiqApiError` carrying the server's own words. */
   async request(path2, options = {}) {
     const response = await this.fetch(path2, options);
@@ -223,7 +239,7 @@ var SkeletiqClient = class {
         headers: {
           Authorization: `Bearer ${this.config.apiKey}`,
           Accept: "application/json",
-          "User-Agent": `${SERVER_NAME}-mcp/${SERVER_VERSION}`,
+          "User-Agent": userAgent(this.hostSource?.()),
           ...options.body === void 0 ? {} : { "Content-Type": "application/json" },
           ...options.headers
         },
@@ -2839,6 +2855,11 @@ function buildServer(client, resolver) {
     { name: SERVER_NAME, version: SERVER_VERSION },
     { instructions: INSTRUCTIONS, capabilities: { tools: {} } }
   );
+  let envelopeHost;
+  recordEnvelopeHost(server, (host) => {
+    envelopeHost = host;
+  });
+  client.setHostSource(() => envelopeHost ?? server.server.getClientVersion());
   registerListProjects(server, resolver);
   registerGetDesign(server, client, resolver);
   registerGenerate(server, client, resolver);
@@ -2847,6 +2868,23 @@ function buildServer(client, resolver) {
   registerRequestDecisionChange(server, client, resolver);
   return server;
 }
+function recordEnvelopeHost(server, record4) {
+  const register = server.registerTool.bind(server);
+  const registerRecording = (name, config, handler) => register(name, config, (...args) => {
+    const host = envelopeHostOf(args.at(-1));
+    if (host) record4(host);
+    return handler(...args);
+  });
+  server.registerTool = registerRecording;
+}
+function envelopeHostOf(ctx) {
+  const envelope = ctx?.mcpReq?.envelope;
+  const info = envelope?.[CLIENT_INFO_META_KEY];
+  if (typeof info !== "object" || info === null) return void 0;
+  const { name, version } = info;
+  if (typeof name !== "string" || !name) return void 0;
+  return { name, version: typeof version === "string" ? version : "" };
+}
 
 // src/index.ts
 function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skeletiq/mcp",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Design in SkeletIQ, build with your coding agent. MCP server for the SkeletIQ architecture platform.",
   "license": "MIT",
   "author": "Sabhahith Works Private Limited",