Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
import { McpServerId, type McpServer } from "@akeru/contracts";
import { describe, expect, it } from "vite-plus/test";
import {
formatMcpServerInstructions,
mcpServerNeedsBrowserAttachment,
sameMcpServerConfigurations,
toAcpMcpServers,
toClaudeMcpServers,
withMcpRuntimeHeaders,
} from "./McpServerConfig.ts";
const servers: readonly McpServer[] = [
{
id: McpServerId.make("search"),
name: "Search",
transport: "url",
url: "https://mcp.example.com",
enabled: true,
createdAt: "2026-01-01T00:00:00.000Z",
updatedAt: "2026-01-01T00:00:00.000Z",
},
{
id: McpServerId.make("local"),
name: "Local",
transport: "stdio",
command: "bunx",
args: ["local-mcp"],
enabled: true,
createdAt: "2026-01-01T00:00:00.000Z",
updatedAt: "2026-01-01T00:00:00.000Z",
},
];
describe("provider MCP configuration", () => {
it("declares browser attachment dependencies independently of connector count", () => {
for (const transport of ["stdio", "url"] as const) {
for (const hosted of [false, true]) {
const base = servers.find((server) => server.transport === transport)!;
for (const id of ["builtin-executor", "builtin-tinyfish"]) {
const server = { ...base, id: McpServerId.make(id) };
expect(mcpServerNeedsBrowserAttachment(server, hosted)).toBe(
transport === "stdio" || hosted,
);
expect(mcpServerNeedsBrowserAttachment({ ...server, enabled: false }, hosted)).toBe(
false,
);
}
for (const id of ["builtin-exa", "composio-session", "raw-mcp", "builtin-computer-use"]) {
expect(
mcpServerNeedsBrowserAttachment({ ...base, id: McpServerId.make(id) }, hosted),
).toBe(false);
}
}
}
});
it("converts filtered servers for ACP adapters", () => {
expect(toAcpMcpServers(servers)).toEqual([
{ type: "http", name: "Search", url: "https://mcp.example.com", headers: [] },
{ name: "Local", command: "bunx", args: ["local-mcp"], env: [] },
]);
});
it("converts filtered servers for Claude", () => {
expect(toClaudeMcpServers(servers)).toEqual({
search: { type: "http", url: "https://mcp.example.com", headers: {} },
local: { type: "stdio", command: "bunx", args: ["local-mcp"] },
});
});
it("forwards transient headers without adding them to the server record", () => {
const server = withMcpRuntimeHeaders({ ...servers[0]! }, { "x-api-key": "secret" });
expect(toAcpMcpServers([server])).toEqual([
{
type: "http",
name: "Search",
url: "https://mcp.example.com",
headers: [{ name: "x-api-key", value: "secret" }],
},
]);
expect(toClaudeMcpServers([server])).toEqual({
search: {
type: "http",
url: "https://mcp.example.com",
headers: { "x-api-key": "secret" },
},
});
expect(JSON.stringify(server)).not.toContain("secret");
});
it("detects a changed transient URL or header for the same server id", () => {
const original = withMcpRuntimeHeaders({ ...servers[0]! }, { "x-api-key": "first" });
const changedUrl = withMcpRuntimeHeaders(
{ ...servers[0]!, url: "https://mcp.example.com/new-session" },
{ "x-api-key": "first" },
);
const changedHeader = withMcpRuntimeHeaders({ ...servers[0]! }, { "x-api-key": "second" });
expect(sameMcpServerConfigurations([original], [original])).toBe(true);
expect(sameMcpServerConfigurations([original], [{ ...original }])).toBe(false);
expect(sameMcpServerConfigurations([original], [changedUrl])).toBe(false);
expect(sameMcpServerConfigurations([original], [changedHeader])).toBe(false);
});
it("reuses a server when transient HTTP header names only change casing", () => {
const lowerCase = withMcpRuntimeHeaders({ ...servers[0]! }, { authorization: "Bearer token" });
const titleCase = withMcpRuntimeHeaders({ ...servers[0]! }, { Authorization: "Bearer token" });
expect(sameMcpServerConfigurations([lowerCase], [titleCase])).toBe(true);
});
it("formats saved MCP server instructions for the bot prompt", () => {
expect(formatMcpServerInstructions(servers)).toBe("");
expect(
formatMcpServerInstructions([
{ ...servers[0]!, instructions: " Search before answering. " },
{ ...servers[1]!, instructions: " " },
]),
).toBe("MCP server guidance:\n- Search (search): Search before answering.");
});
});