@0xmonaco/mcp-server 0.1.1 → 0.3.0

package/CHANGELOG.md

@@ -1,19 +1,15 @@
 # @0xmonaco/mcp-server
 
-## 0.1.1
-
-### Patch Changes
-
-- ce9ff98: Initial 0.1.0 release - Early development version
+## 0.3.0
 
-## 2.0.0
+## 0.1.5
 
-### Documentation Updates
+### Patch Changes
 
-- Updated package information and dependencies
+- 5afd153: Release v0.1.5
 
-## 1.0.0
+## 0.1.1
 
-### Major Changes
+### Patch Changes
 
-- 82a856a: Initial release
+- ce9ff98: Initial 0.1.0 release - Early development version

package/bin/cli.js

@@ -1,46 +1,49 @@
 #!/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';
+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');
+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);
-
+	// 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);
-}
+	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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xmonaco/mcp-server",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "type": "module",
   "description": "MCP server for the Monaco documentation",
   "engines": {
@@ -19,6 +19,6 @@
   },
   "scripts": {
     "start": "tsx src/index.js",
-    "test": "jest"
+    "test": "jest --pass-with-no-tests"
   }
 }

package/src/connect.js

@@ -1,41 +1,41 @@
 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());
-    });
-  };
+	(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.js";
 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");
-  });
+	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.js

@@ -1,50 +1,50 @@
 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());
-    });
-  };
+	(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.js";
 import { initialize } from "./initialize.js";
 import { createSearchTool } from "./search.js";
 import { createTools } from "./tools/index.js";
 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);
-  });
+	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);
+	console.error("Fatal error in trying to initialize MCP server: ", error);
+	process.exit(1);
 });

package/src/initialize.js

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

package/src/search.d.ts

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

package/src/search.js

@@ -1,36 +1,36 @@
 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());
-    });
-  };
+	(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";
@@ -39,80 +39,80 @@ import { SERVER_URL } from "./config.readonly.js";
 import { formatErr, throwOnAxiosError } from "./utils.js";
 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`,
-        ),
-      );
-    }
-  });
+	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,
-      };
-    });
-  });
+	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,
-          };
-        }),
-    );
-  });
+	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

@@ -6,22 +6,11 @@ import { Tool } from "@modelcontextprotocol/sdk/types.js";
 import { ServerParams, ToolWithEndpoint } from "../types.js";
 import { NestedRecord, SimpleRecord } from "../utils.js";
 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 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,