@utdk/mcp 0.1.0-dev.646adf4

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@utdk/mcp",
+  "version": "0.1.0-dev.646adf4",
+  "type": "module",
+  "description": "Unified MCP server with dynamic tool loading from @utdk/* providers",
+  "keywords": [
+    "mcp",
+    "utdk",
+    "modelcontextprotocol",
+    "tools"
+  ],
+  "license": "MIT",
+  "bin": {
+    "utdk-mcp": "./dist/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@utcp/http": "^1.1.1",
+    "@utcp/sdk": "^1.1.0",
+    "@utdk/common": "0.1.0-dev.646adf4"
+  },
+  "optionalDependencies": {
+    "@utdk/datadog": "1.0.0-20260407.1-dev.646adf4",
+    "@utdk/airtable": "0.1.0-20260530.2-dev.646adf4",
+    "@utdk/figma": "0.37.0-20260408.5-dev.646adf4",
+    "@utdk/github": "1.1.4-20260407.6-dev.646adf4",
+    "@utdk/google": "0.0.1-20260407.8-dev.646adf4",
+    "@utdk/hubspot": "3.0.0-20260530.2-dev.646adf4",
+    "@utdk/intercom": "2.15.0-20260530.1-dev.646adf4",
+    "@utdk/linear": "1.0.0-20260530.1-dev.646adf4",
+    "@utdk/jira": "1001.0.0-SNAPSHOT-500abd49de29b046db51cf0460caa503167075c0-20260530.2-dev.646adf4",
+    "@utdk/openai": "2.3.0-20260407.1-dev.646adf4",
+    "@utdk/notion": "1.0.0-20260530.1-dev.646adf4",
+    "@utdk/salesforce": "58.0.0-20260530.1-dev.646adf4",
+    "@utdk/slack": "1.7.0-20260530.1-dev.646adf4",
+    "@utdk/sendgrid": "1.0.0-20260530.1-dev.646adf4",
+    "@utdk/spotify": "1.0.0-20260407.6-dev.646adf4",
+    "@utdk/stripe": "0.0.1-20260530.2-dev.646adf4",
+    "@utdk/twilio": "1.0.0-20260530.2-dev.646adf4",
+    "@utdk/zendesk": "2.0.0-20260530.2-dev.646adf4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vitest": "2.1.5"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check-types": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "start": "node dist/server.js",
+    "dev": "tsx src/server.ts",
+    "test": "vitest run"
+  }
+}

package/src/__tests__/auth.test.ts

@@ -0,0 +1,78 @@
+import { describe, expect, it, afterEach, vi } from "vitest";
+import { buildAuthProvider } from "../auth.js";
+import type { UtdkAuthConfig } from "../auth.js";
+
+afterEach(() => {
+  vi.unstubAllEnvs();
+});
+
+describe("buildAuthProvider", () => {
+  it("returns a BearerToken when GITHUB_TOKEN is set", async () => {
+    vi.stubEnv("GITHUB_TOKEN", "ghp_test123");
+
+    const provider = buildAuthProvider("github", []);
+    expect(provider).not.toBeNull();
+    expect(provider).not.toBeUndefined();
+
+    const headers: Record<string, string> = {};
+    await provider!.authenticate(headers);
+    expect(headers["Authorization"]).toBe("Bearer ghp_test123");
+  });
+
+  it("resolves api_key auth from environment variables", async () => {
+    vi.stubEnv("STRIPE_SECRET_KEY", "sk_test_abc");
+
+    const authConfigs: UtdkAuthConfig[] = [
+      {
+        auth_type: "api_key",
+        api_key: "Bearer ${STRIPE_SECRET_KEY}",
+        var_name: "Authorization",
+        location: "header",
+      },
+    ];
+
+    const provider = buildAuthProvider("stripe", authConfigs);
+    expect(provider).not.toBeUndefined();
+
+    const headers: Record<string, string> = {};
+    await provider!.authenticate(headers);
+    expect(headers["Authorization"]).toBe("Bearer sk_test_abc");
+  });
+
+  it("returns undefined when no credentials are available", () => {
+    vi.unstubAllEnvs();
+
+    const authConfigs: UtdkAuthConfig[] = [
+      {
+        auth_type: "api_key",
+        api_key: "Bearer ${GITHUB_TOKEN}",
+        var_name: "Authorization",
+        location: "header",
+      },
+    ];
+
+    const provider = buildAuthProvider("github", authConfigs);
+    expect(provider).toBeUndefined();
+  });
+
+  it("prefers PROVIDER_TOKEN over utdk.auth config", async () => {
+    vi.stubEnv("GITHUB_TOKEN", "ghp_from_env");
+    vi.stubEnv("SOME_OTHER_TOKEN", "other_token");
+
+    const authConfigs: UtdkAuthConfig[] = [
+      {
+        auth_type: "api_key",
+        api_key: "Bearer ${SOME_OTHER_TOKEN}",
+        var_name: "Authorization",
+        location: "header",
+      },
+    ];
+
+    const provider = buildAuthProvider("github", authConfigs);
+    const headers: Record<string, string> = {};
+    await provider!.authenticate(headers);
+
+    // GITHUB_TOKEN takes priority
+    expect(headers["Authorization"]).toBe("Bearer ghp_from_env");
+  });
+});

package/src/__tests__/loader.test.ts

@@ -0,0 +1,264 @@
+import { describe, expect, it, vi, afterEach, beforeEach } from "vitest";
+import { parseProviderNames, loadProviders, executeTool } from "../loader.js";
+import type { ProviderTool } from "../loader.js";
+
+afterEach(() => {
+  vi.restoreAllMocks();
+  vi.unstubAllEnvs();
+});
+
+// ---------------------------------------------------------------------------
+// parseProviderNames
+// ---------------------------------------------------------------------------
+
+describe("parseProviderNames", () => {
+  it("parses comma-separated provider names", () => {
+    expect(parseProviderNames("github,slack,stripe")).toEqual(["github", "slack", "stripe"]);
+  });
+
+  it("trims whitespace", () => {
+    expect(parseProviderNames("github, slack , stripe")).toEqual(["github", "slack", "stripe"]);
+  });
+
+  it("lowercases names", () => {
+    expect(parseProviderNames("GitHub,Slack")).toEqual(["github", "slack"]);
+  });
+
+  it("returns empty array for undefined", () => {
+    expect(parseProviderNames(undefined)).toEqual([]);
+  });
+
+  it("returns empty array for empty string", () => {
+    expect(parseProviderNames("")).toEqual([]);
+  });
+
+  it("filters empty entries from double commas", () => {
+    expect(parseProviderNames("github,,slack")).toEqual(["github", "slack"]);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// loadProviders
+// ---------------------------------------------------------------------------
+
+describe("loadProviders", () => {
+  it("returns an empty array for an unknown provider", async () => {
+    const tools = await loadProviders(["__nonexistent_provider__"]);
+    expect(tools).toEqual([]);
+  });
+
+  it("returns an empty array for an empty provider list", async () => {
+    const tools = await loadProviders([]);
+    expect(tools).toEqual([]);
+  });
+
+  it("loads tools from github provider (integration)", async () => {
+    // This test requires the @utdk/github package to be present in the workspace.
+    // It verifies that the loader correctly converts the OpenAPI doc to MCP tools.
+    const tools = await loadProviders(["github"]);
+
+    expect(tools.length).toBeGreaterThan(0);
+
+    // All tools should have required fields
+    for (const tool of tools) {
+      expect(tool.mcpName).toMatch(/^[a-zA-Z0-9_-]+$/);
+      expect(tool.providerName).toBe("github");
+      expect(tool.description).toBeTruthy();
+      expect(tool.method).toMatch(/^(GET|POST|PUT|PATCH|DELETE)$/);
+      expect(tool.routeTemplate).toMatch(/^https?:\/\//);
+      expect(tool.inputSchema).toBeDefined();
+    }
+  });
+
+  it("loads tools from stripe provider (integration)", async () => {
+    const tools = await loadProviders(["stripe"]);
+
+    expect(tools.length).toBeGreaterThan(0);
+
+    const tool = tools[0];
+    expect(tool).toBeDefined();
+    if (!tool) return;
+
+    expect(tool.providerName).toBe("stripe");
+    expect(tool.inputSchema["type"]).toBe("object");
+  });
+
+  it("loads tools from multiple providers simultaneously", async () => {
+    const tools = await loadProviders(["github", "stripe"]);
+
+    expect(tools.length).toBeGreaterThan(0);
+
+    const githubTools = tools.filter((t) => t.providerName === "github");
+    const stripeTools = tools.filter((t) => t.providerName === "stripe");
+
+    expect(githubTools.length).toBeGreaterThan(0);
+    expect(stripeTools.length).toBeGreaterThan(0);
+  });
+
+  it("tool names are MCP-safe (no dots or slashes)", async () => {
+    const tools = await loadProviders(["github"]);
+    for (const tool of tools) {
+      expect(tool.mcpName).not.toContain(".");
+      expect(tool.mcpName).not.toContain("/");
+    }
+  });
+
+  it("input schemas have type: object", async () => {
+    const tools = await loadProviders(["stripe"]);
+    for (const tool of tools) {
+      const schema = tool.inputSchema;
+      expect(schema["type"]).toBe("object");
+    }
+  });
+
+  it("populates tags from OpenAPI operation tags", async () => {
+    const tools = await loadProviders(["github"]);
+    expect(tools.length).toBeGreaterThan(0);
+
+    // Every tool should have a tags array (may be empty for untagged operations)
+    for (const tool of tools) {
+      expect(Array.isArray(tool.tags)).toBe(true);
+    }
+
+    // At least some tools should have non-empty tags
+    const taggedTools = tools.filter((t) => t.tags.length > 0);
+    expect(taggedTools.length).toBeGreaterThan(0);
+
+    // Tags should be strings
+    for (const tool of taggedTools) {
+      for (const tag of tool.tags) {
+        expect(typeof tag).toBe("string");
+      }
+    }
+  });
+});
+
+// ---------------------------------------------------------------------------
+// executeTool — unit tests with mocked fetch
+// ---------------------------------------------------------------------------
+
+describe("executeTool", () => {
+  const mockTool: ProviderTool = {
+    mcpName: "github__repos_list_for_user",
+    utcpName: "github.repos/listForUser",
+    description: "List public repositories for the specified user.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        username: { type: "string", description: "The handle for the GitHub user account." },
+        per_page: { type: "integer" },
+      },
+      required: ["username"],
+    },
+    providerName: "github",
+    tags: ["repos"],
+    method: "GET",
+    routeTemplate: "https://api.github.com/users/{username}/repos",
+    contentType: "application/json",
+    pathParamKeys: ["username"],
+    queryParamKeys: ["per_page"],
+    auth: undefined,
+  };
+
+  beforeEach(() => {
+    vi.stubGlobal("fetch", vi.fn());
+  });
+
+  it("substitutes path parameters and makes a GET request", async () => {
+    const mockFetch = vi.mocked(fetch);
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify([{ id: 1, name: "repo1" }]), {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+      }),
+    );
+
+    const result = await executeTool(mockTool, { username: "octocat", per_page: 10 });
+
+    expect(mockFetch).toHaveBeenCalledOnce();
+    const [calledUrl, calledInit] = mockFetch.mock.calls[0] as [string, RequestInit];
+
+    expect(calledUrl).toContain("octocat");
+    expect(calledUrl).not.toContain("{username}");
+    expect(calledInit.method).toBe("GET");
+    expect(result).toEqual([{ id: 1, name: "repo1" }]);
+  });
+
+  it("appends non-path args as query parameters for GET requests", async () => {
+    const mockFetch = vi.mocked(fetch);
+    mockFetch.mockResolvedValueOnce(
+      new Response("[]", {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+      }),
+    );
+
+    await executeTool(mockTool, { username: "octocat", per_page: 5 });
+
+    const [calledUrl] = mockFetch.mock.calls[0] as [string, RequestInit];
+    expect(calledUrl).toContain("per_page=5");
+  });
+
+  it("applies auth headers when auth provider is present", async () => {
+    const mockFetch = vi.mocked(fetch);
+    mockFetch.mockResolvedValueOnce(
+      new Response("{}", {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+      }),
+    );
+
+    const toolWithAuth: ProviderTool = {
+      ...mockTool,
+      auth: {
+        authenticate: async (headers) => {
+          headers["Authorization"] = "Bearer test-token";
+        },
+      },
+    };
+
+    await executeTool(toolWithAuth, { username: "octocat" });
+
+    const [, calledInit] = mockFetch.mock.calls[0] as [string, RequestInit];
+    const headers = calledInit.headers as Record<string, string>;
+    expect(headers["Authorization"]).toBe("Bearer test-token");
+  });
+
+  it("sends JSON body for POST requests", async () => {
+    const postTool: ProviderTool = {
+      ...mockTool,
+      method: "POST",
+      routeTemplate: "https://api.github.com/user/repos",
+      pathParamKeys: [],
+      queryParamKeys: [],
+      mcpName: "github__repos_create_for_authenticated_user",
+      utcpName: "github.repos/createForAuthenticatedUser",
+    };
+
+    const mockFetch = vi.mocked(fetch);
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify({ id: 42, name: "new-repo" }), {
+        status: 201,
+        headers: { "Content-Type": "application/json" },
+      }),
+    );
+
+    const result = await executeTool(postTool, { name: "new-repo", private: true });
+
+    const [, calledInit] = mockFetch.mock.calls[0] as [string, RequestInit];
+    expect(calledInit.method).toBe("POST");
+    expect(calledInit.body).toBe(JSON.stringify({ name: "new-repo", private: true }));
+    expect(result).toEqual({ id: 42, name: "new-repo" });
+  });
+
+  it("throws on non-ok HTTP responses", async () => {
+    const mockFetch = vi.mocked(fetch);
+    mockFetch.mockResolvedValueOnce(
+      new Response("Not Found", { status: 404 }),
+    );
+
+    await expect(executeTool(mockTool, { username: "nonexistent" })).rejects.toThrow(
+      "Tool call failed: 404",
+    );
+  });
+});

package/src/__tests__/search.test.ts

@@ -0,0 +1,243 @@
+import { describe, expect, it } from "vitest";
+import { tokenize, buildTfIdf, searchTools, groupTools } from "../search.js";
+import type { ProviderTool } from "../loader.js";
+
+// ---------------------------------------------------------------------------
+// Shared test fixtures
+// ---------------------------------------------------------------------------
+
+function makeTool(overrides: Partial<ProviderTool> & { mcpName: string }): ProviderTool {
+  return {
+    utcpName: overrides.mcpName.replace(/__/g, "."),
+    description: "",
+    inputSchema: { type: "object" },
+    providerName: "testprovider",
+    tags: [],
+    method: "GET",
+    routeTemplate: "https://api.example.com/test",
+    contentType: "application/json",
+    pathParamKeys: [],
+    queryParamKeys: [],
+    auth: undefined,
+    ...overrides,
+  };
+}
+
+const reposTool = makeTool({
+  mcpName: "github__repos_list",
+  providerName: "github",
+  description: "List public repositories for the specified user.",
+  tags: ["repos"],
+});
+
+const issuesTool = makeTool({
+  mcpName: "github__issues_list",
+  providerName: "github",
+  description: "List issues assigned to the authenticated user across all visible repositories.",
+  tags: ["issues"],
+});
+
+const prTool = makeTool({
+  mcpName: "github__pulls_list",
+  providerName: "github",
+  description: "List pull requests in a repository.",
+  tags: ["pulls"],
+});
+
+const slackTool = makeTool({
+  mcpName: "slack__messages_send",
+  providerName: "slack",
+  description: "Send a message to a Slack channel.",
+  tags: ["messaging"],
+});
+
+const ALL_TOOLS = [reposTool, issuesTool, prTool, slackTool];
+
+// ---------------------------------------------------------------------------
+// tokenize
+// ---------------------------------------------------------------------------
+
+describe("tokenize", () => {
+  it("lowercases and splits on non-alphanumeric chars", () => {
+    expect(tokenize("hello world")).toEqual(["hello", "world"]);
+  });
+
+  it("splits snake_case / double-underscore MCP names", () => {
+    expect(tokenize("github__repos_list")).toEqual(["github", "repos", "list"]);
+  });
+
+  it("splits camelCase boundaries", () => {
+    expect(tokenize("listForUser")).toEqual(["list", "for", "user"]);
+  });
+
+  it("strips punctuation", () => {
+    expect(tokenize("security-advisories")).toEqual(["security", "advisories"]);
+  });
+
+  it("returns empty array for empty string", () => {
+    expect(tokenize("")).toEqual([]);
+  });
+
+  it("filters empty tokens", () => {
+    expect(tokenize("  hello   world  ")).toEqual(["hello", "world"]);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// buildTfIdf
+// ---------------------------------------------------------------------------
+
+describe("buildTfIdf", () => {
+  it("returns zero score for empty corpus", () => {
+    const score = buildTfIdf([]);
+    expect(score(reposTool, ["repos"])).toBe(0);
+  });
+
+  it("scores tool with name match higher than description-only match", () => {
+    const tools = [reposTool, issuesTool];
+    const score = buildTfIdf(tools);
+    // "repos" is in reposTool name AND tags but NOT in issuesTool name or tags
+    const reposScore = score(reposTool, ["repos"]);
+    const issuesScore = score(issuesTool, ["repos"]);
+    expect(reposScore).toBeGreaterThan(0);
+    expect(issuesScore).toBe(0);
+  });
+
+  it("returns higher score for rare term (IDF effect)", () => {
+    // "list" appears in all github tools but "pull" only in prTool
+    const tools = [reposTool, issuesTool, prTool];
+    const score = buildTfIdf(tools);
+    const scoreOnPullRare = score(prTool, ["pull"]);
+    const scoreOnListCommon = score(prTool, ["list"]);
+    // "pull" is rarer than "list" so IDF is higher → pull score > list score
+    expect(scoreOnPullRare).toBeGreaterThan(scoreOnListCommon);
+  });
+
+  it("returns positive score for a matching term in description", () => {
+    const tools = [slackTool];
+    const score = buildTfIdf(tools);
+    expect(score(slackTool, ["channel"])).toBeGreaterThan(0);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// searchTools
+// ---------------------------------------------------------------------------
+
+describe("searchTools", () => {
+  it("returns empty array for empty query", () => {
+    expect(searchTools(ALL_TOOLS, "", undefined, 10)).toEqual([]);
+  });
+
+  it("returns empty array for blank query", () => {
+    expect(searchTools(ALL_TOOLS, "   ", undefined, 10)).toEqual([]);
+  });
+
+  it("finds tools by name keyword", () => {
+    const results = searchTools(ALL_TOOLS, "repos", undefined, 10);
+    expect(results.map((r) => r.name)).toContain("github__repos_list");
+  });
+
+  it("finds tools by tag", () => {
+    const results = searchTools(ALL_TOOLS, "issues", undefined, 10);
+    expect(results.map((r) => r.name)).toContain("github__issues_list");
+  });
+
+  it("finds tools by description keyword", () => {
+    const results = searchTools(ALL_TOOLS, "channel", undefined, 10);
+    expect(results.map((r) => r.name)).toContain("slack__messages_send");
+  });
+
+  it("excludes tools where a query word does not appear anywhere", () => {
+    const results = searchTools(ALL_TOOLS, "nonexistent_xyz", undefined, 10);
+    expect(results).toHaveLength(0);
+  });
+
+  it("requires ALL query words to match", () => {
+    // "repos" matches reposTool, "channel" matches slackTool → no tool matches both
+    const results = searchTools(ALL_TOOLS, "repos channel", undefined, 10);
+    expect(results).toHaveLength(0);
+  });
+
+  it("respects provider filter", () => {
+    const results = searchTools(ALL_TOOLS, "list", "slack", 10);
+    // slackTool description has "list" via "List" — but depends on description
+    // More importantly, github tools should NOT appear
+    expect(results.every((r) => r.name.startsWith("slack__"))).toBe(true);
+  });
+
+  it("respects limit", () => {
+    const results = searchTools(ALL_TOOLS, "list", undefined, 2);
+    expect(results.length).toBeLessThanOrEqual(2);
+  });
+
+  it("returns tags in results", () => {
+    const results = searchTools(ALL_TOOLS, "repos", undefined, 10);
+    const reposResult = results.find((r) => r.name === "github__repos_list");
+    expect(reposResult?.tags).toEqual(["repos"]);
+  });
+
+  it("ranks name matches above description-only matches", () => {
+    // "repos" is in the name of reposTool but only in description of issuesTool
+    const tools = [
+      reposTool,
+      makeTool({
+        mcpName: "github__something_else",
+        providerName: "github",
+        description: "Access repos for any organization.",
+        tags: [],
+      }),
+    ];
+    const results = searchTools(tools, "repos", undefined, 10);
+    // reposTool (name match) should come before the description-only match
+    expect(results[0]?.name).toBe("github__repos_list");
+  });
+});
+
+// ---------------------------------------------------------------------------
+// groupTools
+// ---------------------------------------------------------------------------
+
+describe("groupTools", () => {
+  it("groups by provider", () => {
+    const grouped = groupTools(ALL_TOOLS, "provider");
+    expect(grouped["github"]).toEqual(
+      expect.arrayContaining(["github__repos_list", "github__issues_list", "github__pulls_list"]),
+    );
+    expect(grouped["slack"]).toEqual(["slack__messages_send"]);
+  });
+
+  it("groups by tag", () => {
+    const grouped = groupTools(ALL_TOOLS, "tag");
+    expect(grouped["repos"]).toEqual(["github__repos_list"]);
+    expect(grouped["issues"]).toEqual(["github__issues_list"]);
+    expect(grouped["pulls"]).toEqual(["github__pulls_list"]);
+    expect(grouped["messaging"]).toEqual(["slack__messages_send"]);
+  });
+
+  it("falls back to provider name for tools with no tags when grouping by tag", () => {
+    const noTagTool = makeTool({
+      mcpName: "provider__notag_tool",
+      providerName: "myprovider",
+      tags: [],
+    });
+    const grouped = groupTools([noTagTool], "tag");
+    expect(grouped["myprovider"]).toEqual(["provider__notag_tool"]);
+  });
+
+  it("returns empty object for empty tool list", () => {
+    expect(groupTools([], "provider")).toEqual({});
+    expect(groupTools([], "tag")).toEqual({});
+  });
+
+  it("assigns multi-tag tool to all its tag groups", () => {
+    const multiTagTool = makeTool({
+      mcpName: "github__multi_tool",
+      providerName: "github",
+      tags: ["repos", "admin"],
+    });
+    const grouped = groupTools([multiTagTool], "tag");
+    expect(grouped["repos"]).toContain("github__multi_tool");
+    expect(grouped["admin"]).toContain("github__multi_tool");
+  });
+});