@0xmonaco/mcp-server 0.5.6 → 0.5.8

package/package.json

@@ -1,28 +1,40 @@
 {
 	"name": "@0xmonaco/mcp-server",
-	"version": "0.5.6",
+	"version": "0.5.8",
 	"type": "module",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/Monaco-Research/monaco-sdk.git",
 		"directory": "packages/mcp-server"
 	},
-	"description": "MCP server for the Monaco documentation",
+	"description": "MCP server for the Monaco SDK",
 	"engines": {
-		"node": ">=18.0.0"
+		"node": ">=18"
 	},
-	"bin": "./bin/cli.js",
-	"main": "src/index.js",
+	"bin": "./dist/bin.js",
+	"files": [
+		"dist"
+	],
 	"scripts": {
-		"start": "tsx src/index.js"
+		"build": "bun build src/bin.ts --outdir dist --target node --format esm --minify",
+		"dev": "bun --watch src/bin.ts",
+		"start": "bun dist/bin.js",
+		"clean": "rm -rf dist",
+		"lint": "biome lint .",
+		"test": "bun test"
 	},
 	"author": "@codebycarson",
 	"dependencies": {
-		"@mintlify/openapi-types": "^0.0.0",
-		"@mintlify/validation": "^0.1.320",
-		"@modelcontextprotocol/sdk": "^1.6.1",
-		"axios": "^1.8.1",
-		"dashify": "^2.0.0",
-		"trieve-ts-sdk": "^0.0.62"
+		"@0xmonaco/core": "*",
+		"@0xmonaco/types": "*",
+		"@modelcontextprotocol/sdk": "^1.26.0",
+		"node-fetch": "^3.3.2",
+		"viem": "^2.45.2",
+		"ws": "^8.19.0",
+		"zod": "^4.0.0"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"@types/ws": "^8.18.1"
 	}
 }

package/CHANGELOG.md

@@ -1,55 +0,0 @@
-# @0xmonaco/mcp-server
-
-## 0.5.6
-
-## 0.5.5
-
-## 0.5.4
-
-## 0.5.3
-
-### Patch Changes
-
-- a0163e3: chore: add auto-connect flag for authenticated ws channels
-
-## 0.5.2
-
-## 0.5.1
-
-## 0.5.0
-
-### Minor Changes
-
-- 529e401: Refactor vault deposit/withdraw to use asset IDs
-
-### Patch Changes
-
-- d8fd27c: Switch balances query to use asset id rather than token contract address.
-
-## 0.4.2
-
-### Patch Changes
-
-- c7c9b97: Orderbook websocket updates + websocket class removal in favor of functional websockets
-
-## 0.4.1
-
-## 0.4.0
-
-## 0.3.2
-
-## 0.3.1
-
-## 0.3.0
-
-## 0.1.5
-
-### Patch Changes
-
-- 5afd153: Release v0.1.5
-
-## 0.1.1
-
-### Patch Changes
-
-- ce9ff98: Initial 0.1.0 release - Early development version

package/bin/cli.js

@@ -1,49 +0,0 @@
-#!/usr/bin/env node
-
-import { fileURLToPath } from "node:url";
-import { dirname, resolve } from "node:path";
-import { spawn } from "node:child_process";
-import { createRequire } from "node:module";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const require = createRequire(import.meta.url);
-
-// Path to the main MCP server
-const scriptPath = resolve(__dirname, "../src/index.js");
-
-try {
-	// Check if the built files exist
-	require.resolve(scriptPath);
-
-	// Execute the server
-	const server = spawn("node", [scriptPath], {
-		stdio: "inherit",
-		shell: false,
-	});
-
-	server.on("error", (err) => {
-		console.error("Failed to start server:", err);
-		process.exit(1);
-	});
-
-	// Handle clean shutdown
-	const cleanup = () => {
-		if (!server.killed) {
-			server.kill();
-		}
-	};
-
-	process.on("SIGINT", cleanup);
-	process.on("SIGTERM", cleanup);
-	process.on("exit", cleanup);
-} catch (error) {
-	console.error(
-		"Error: Server files not found. The package may not be built correctly.",
-	);
-	console.error(
-		"Please try reinstalling the package or contact the maintainers.",
-	);
-	console.error(error);
-	process.exit(1);
-}

package/settings.d.ts

@@ -1,2 +0,0 @@
-export declare const SERVER_NAME: string;
-export declare const SERVER_VERSION: string;

package/settings.js

@@ -1,2 +0,0 @@
-export const SERVER_NAME = "mintlify";
-export const SERVER_VERSION = "1.0.0";

package/src/config.readonly.d.ts

@@ -1,2 +0,0 @@
-export declare const SUBDOMAIN: Readonly<string>;
-export declare const SERVER_URL: Readonly<string>;

package/src/config.readonly.js

@@ -1,3 +0,0 @@
-// read-only
-export const SUBDOMAIN = "monaco";
-export const SERVER_URL = "https://leaves.mintlify.com";

package/src/connect.d.ts

@@ -1,2 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
-export declare function connectServer(server: McpServer): Promise<void>;

package/src/connect.js

@@ -1,41 +0,0 @@
-var __awaiter =
-	(this && this.__awaiter) ||
-	function (thisArg, _arguments, P, generator) {
-		function adopt(value) {
-			return value instanceof P
-				? value
-				: new P(function (resolve) {
-						resolve(value);
-					});
-		}
-		return new (P || (P = Promise))(function (resolve, reject) {
-			function fulfilled(value) {
-				try {
-					step(generator.next(value));
-				} catch (e) {
-					reject(e);
-				}
-			}
-			function rejected(value) {
-				try {
-					step(generator["throw"](value));
-				} catch (e) {
-					reject(e);
-				}
-			}
-			function step(result) {
-				result.done
-					? resolve(result.value)
-					: adopt(result.value).then(fulfilled, rejected);
-			}
-			step((generator = generator.apply(thisArg, _arguments || [])).next());
-		});
-	};
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";
-export function connectServer(server) {
-	return __awaiter(this, void 0, void 0, function* () {
-		const transport = new StdioServerTransport();
-		yield server.connect(transport);
-		console.error("MCP Server running on stdio");
-	});
-}

package/src/index.d.ts

@@ -1 +0,0 @@
-export {};

package/src/index.js

@@ -1,50 +0,0 @@
-var __awaiter =
-	(this && this.__awaiter) ||
-	function (thisArg, _arguments, P, generator) {
-		function adopt(value) {
-			return value instanceof P
-				? value
-				: new P(function (resolve) {
-						resolve(value);
-					});
-		}
-		return new (P || (P = Promise))(function (resolve, reject) {
-			function fulfilled(value) {
-				try {
-					step(generator.next(value));
-				} catch (e) {
-					reject(e);
-				}
-			}
-			function rejected(value) {
-				try {
-					step(generator["throw"](value));
-				} catch (e) {
-					reject(e);
-				}
-			}
-			function step(result) {
-				result.done
-					? resolve(result.value)
-					: adopt(result.value).then(fulfilled, rejected);
-			}
-			step((generator = generator.apply(thisArg, _arguments || [])).next());
-		});
-	};
-import { connectServer } from "./connect";
-import { initialize } from "./initialize";
-import { createSearchTool } from "./search";
-import { createTools } from "./tools";
-function main() {
-	return __awaiter(this, void 0, void 0, function* () {
-		const server = initialize();
-		const existingTools = new Set();
-		yield createSearchTool(server);
-		yield createTools(server, existingTools);
-		yield connectServer(server);
-	});
-}
-main().catch((error) => {
-	console.error("Fatal error in trying to initialize MCP server: ", error);
-	process.exit(1);
-});

package/src/initialize.d.ts

@@ -1,2 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
-export declare function initialize(): McpServer;

package/src/initialize.js

@@ -1,10 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
-import { SERVER_NAME, SERVER_VERSION } from "../settings";
-export function initialize() {
-	console.error("Initializing MCP Server...");
-	const server = new McpServer({
-		name: SERVER_NAME,
-		version: SERVER_VERSION,
-	});
-	return server;
-}

package/src/search.d.ts

@@ -1,4 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
-import type { InitializationConfiguration } from "./types";
-export declare function fetchSearchConfigurationAndTools(subdomain: string): Promise<InitializationConfiguration>;
-export declare function createSearchTool(server: McpServer): Promise<void>;

package/src/search.js

@@ -1,118 +0,0 @@
-var __awaiter =
-	(this && this.__awaiter) ||
-	function (thisArg, _arguments, P, generator) {
-		function adopt(value) {
-			return value instanceof P
-				? value
-				: new P(function (resolve) {
-						resolve(value);
-					});
-		}
-		return new (P || (P = Promise))(function (resolve, reject) {
-			function fulfilled(value) {
-				try {
-					step(generator.next(value));
-				} catch (e) {
-					reject(e);
-				}
-			}
-			function rejected(value) {
-				try {
-					step(generator["throw"](value));
-				} catch (e) {
-					reject(e);
-				}
-			}
-			function step(result) {
-				result.done
-					? resolve(result.value)
-					: adopt(result.value).then(fulfilled, rejected);
-			}
-			step((generator = generator.apply(thisArg, _arguments || [])).next());
-		});
-	};
-import axios from "axios";
-import { TrieveSDK } from "trieve-ts-sdk";
-import { z } from "zod";
-import { SUBDOMAIN } from "./config.readonly";
-import { SERVER_URL } from "./config.readonly";
-import { formatErr, throwOnAxiosError } from "./utils";
-const DEFAULT_BASE_URL = "https://api.mintlifytrieve.com";
-export function fetchSearchConfigurationAndTools(subdomain) {
-	return __awaiter(this, void 0, void 0, function* () {
-		try {
-			const response = yield axios.get(
-				`${SERVER_URL}/api/mcp/config/${subdomain}`,
-				{
-					validateStatus() {
-						return true;
-					},
-				},
-			);
-			throwOnAxiosError(response, "Failed to fetch MCP config");
-			return response.data;
-		} catch (err) {
-			throw new Error(
-				formatErr(err).replace(
-					"Request failed with status code 404",
-					`${subdomain} not found`,
-				),
-			);
-		}
-	});
-}
-function search(query, config) {
-	return __awaiter(this, void 0, void 0, function* () {
-		const trieve = new TrieveSDK({
-			apiKey: config.trieveApiKey,
-			datasetId: config.trieveDatasetId,
-			baseUrl: DEFAULT_BASE_URL,
-		});
-		const data = yield trieve.autocomplete({
-			page_size: 10,
-			query,
-			search_type: "fulltext",
-			extend_results: true,
-			score_threshold: 1,
-		});
-		if (data.chunks === undefined || data.chunks.length === 0) {
-			throw new Error("No results found");
-		}
-		return data.chunks.map((result) => {
-			const { chunk } = result;
-			// TODO: Append custom domain to the link
-			return {
-				title: chunk.metadata.title,
-				content: chunk.chunk_html,
-				link: chunk.link,
-			};
-		});
-	});
-}
-export function createSearchTool(server) {
-	return __awaiter(this, void 0, void 0, function* () {
-		const config = yield fetchSearchConfigurationAndTools(SUBDOMAIN);
-		server.tool(
-			"search",
-			`Search across the ${config.name} documentation to fetch relevant context for a given query`,
-			{
-				query: z.string(),
-			},
-			(_a) =>
-				__awaiter(this, [_a], void 0, function* ({ query }) {
-					const results = yield search(query, config);
-					const content = results.map((result) => {
-						const { title, content, link } = result;
-						const text = `Title: ${title}\nContent: ${content}\nLink: ${link}`;
-						return {
-							type: "text",
-							text,
-						};
-					});
-					return {
-						content,
-					};
-				}),
-		);
-	});
-}

package/src/tools/helpers.d.ts

@@ -1,32 +0,0 @@
-import type { OpenAPI } from "@mintlify/openapi-types";
-import type { DataSchemaArray, Endpoint, HttpMethod, SecurityParameterGroup } from "@mintlify/validation";
-import type { Tool } from "@modelcontextprotocol/sdk/types";
-import type { ServerParams, ToolWithEndpoint } from "../types";
-import type { NestedRecord, SimpleRecord } from "../utils";
-export declare function convertStrToTitle(str: string): string;
-export declare function findNextIteration(set: Set<string>, str: string): number;
-export declare function getMcpEnabledEndpointsFromOpenApiSpec(spec: OpenAPI.Document): Endpoint<DataSchemaArray>[];
-export declare function convertEndpointToTool(endpoint: Endpoint<DataSchemaArray>): Omit<Tool, "inputSchema">;
-export declare function getMcpToolsAndEndpointsFromOpenApiSpec(spec: OpenAPI.Document): ToolWithEndpoint[];
-export declare function getEndpointsFromOpenApi(specification: OpenAPI.Document): Endpoint<DataSchemaArray>[];
-export declare function loadEnv(key: string): SimpleRecord;
-export declare function convertSecurityParameterSection(
-  securityParameters: SecurityParameterGroup,
-  envVariables: SimpleRecord,
-  location: string,
-): {
-  key: string;
-  value: NestedRecord | undefined;
-}[];
-export declare function convertEndpointToCategorizedZod(
-  envKey: string,
-  endpoint: Endpoint,
-): {
-  url: string;
-  method: HttpMethod;
-  paths: ServerParams;
-  queries: ServerParams;
-  body: ServerParams | undefined;
-  headers: ServerParams;
-  cookies: ServerParams;
-};