@h1deya/mcp-client-cli 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 hideya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,258 @@
+# Simple MCP Client to Explore MCP Servers / TypeScript [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/hideya/mcp-langchain-client-ts/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/@h1deya/mcp-client-cli.svg)](https://www.npmjs.com/package/@h1deya/mcp-client-cli)
+
+
+**Quickly test and explore MCP servers from the command line!**
+
+A simple, text-based CLI client for [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers built with LangChain and TypeScript.  
+This tool automatically adjusts the schema for LLM compatibility, which can help some failing MCP servers run successfully.  
+Suitable for testing MCP servers, exploring their capabilities, and prototyping integrations.
+
+Internally it uses  [LangChain ReAct Agent](https://github.com/langchain-ai/react-agent-js) and
+a utility function `convertMcpToLangchainTools()` from
+[`@h1deya/langchain-mcp-tools`](https://www.npmjs.com/package/@h1deya/langchain-mcp-tools).
+This function performs the aforementioned MCP tools schema transformations for LLM compatibility.
+See [this page](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/README.md#llm-provider-schema-compatibility)
+for details.
+
+A Python equivalent of this utility is available [here](https://pypi.org/project/mcp-chat/)
+
+## Prerequisites
+
+- Node.js 18+
+- [optional] [`uv` (`uvx`)](https://docs.astral.sh/uv/getting-started/installation/)
+  installed to run Python-based local (stdio) MCP servers
+- LLM API keys from
+  [OpenAI](https://platform.openai.com/api-keys),
+  [Anthropic](https://console.anthropic.com/settings/keys),
+  and/or
+  [Google AI Studio (for GenAI/Gemini)](https://aistudio.google.com/apikey)
+  as needed
+
+## Quick Start
+
+- Install `mcp-client-cli` tool.
+  This can take up to a few minutes to complete:
+  ```bash
+  npm install -g @h1deya/mcp-client-cli
+  ```
+
+- Configure LLM and MCP Servers settings via the configuration file, `llm_mcp_config.json5`
+  ```bash
+  code llm_mcp_config.json5
+  ```
+
+  The following is a simple configuration for quick testing:
+  ```json5
+  {
+    "llm": {
+      "model_provider": "openai",
+      "model": "gpt-4o-mini",
+      // "model_provider": "anthropic",
+      // "model": "claude-3-5-haiku-latest",
+      // "model_provider": "google_genai",
+      // "model": "gemini-2.5-flash",
+    },
+
+    "mcp_servers": {
+      "us-weather": {  // US weather only
+        "command": "npx", 
+        "args": ["-y", "@h1deya/mcp-server-weather"]
+      },
+    },
+
+    "example_queries": [
+      "Tell me how LLMs work in a few sentences",
+      "Are there any weather alerts in California?",
+    ],
+  }
+  ```
+
+- Set up API keys
+  ```bash
+  echo "ANTHROPIC_API_KEY=sk-ant-...                                       
+  OPENAI_API_KEY=sk-proj-...
+  GOOGLE_API_KEY=AI..." > .env
+  
+  code .env
+  ```
+
+- Run the tool
+  ```bash
+  mcp-client-cli
+  ```
+  By default, it reads the configuration file, `llm_mcp_config.json5`, from the current directory.  
+  Then, it applies the environment variables specified in the `.env` file,
+  as well as the ones that are already defined.
+
+## Building from Source
+
+See [README_DEV.md](https://github.com/hideya/mcp-client-langchain-ts/blob/main/README_DEV.md) for details.
+
+## Features
+
+- **Easy setup**: Works out of the box with popular MCP servers
+- **Flexible configuration**: JSON5 config with environment variable support
+- **Multiple LLM providers**: OpenAI, Anthropic, Google (GenAI)
+- **Schema Compatibility Support**: Automatically adjusts tools schema for LLM compatibility, which can help some failing MCP servers run successfully. 
+  See [this page](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/README.md#llm-provider-schema-compatibility)
+for details.
+- **Command & URL servers**: Support for both local and remote MCP servers
+- **Real-time logging**: Live stdio MCP server logs with customizable log directory
+- **Interactive testing**: Example queries for the convenience of repeated testing
+
+## Limitations
+
+- **Tool Return Types**: Currently, only text results of tool calls are supported.
+It uses LangChain's `response_format: 'content'` (the default) internally, which only supports text strings.
+While MCP tools can return multiple content types (text, images, etc.), this library currently filters and uses only text content.
+- **MCP Features**: Only MCP [Tools](https://modelcontextprotocol.io/docs/concepts/tools) are supported. Other MCP features like Resources, Prompts, and Sampling are not implemented.
+
+## Usage
+
+### Basic Usage
+
+```bash
+mcp-client-cli
+```
+
+By default, it reads the configuration file, `llm_mcp_config.json5`, from the current directory.  
+Then, it applies the environment variables specified in the `.env` file,
+as well as the ones that are already defined.  
+It outputs local MCP server logs to the current directory.
+
+### With Options
+
+```bash
+# Specify the config file to use
+mcp-client-cli --config my-config.json5
+
+# Store local (stdio) MCP server logs in specific directory
+mcp-client-cli --log-dir ./logs
+
+# Enable verbose logging
+mcp-client-cli --verbose
+
+# Show help
+mcp-client-cli --help
+```
+
+## Supported LLM Providers
+
+- **OpenAI**: `o4-mini`, `gpt-4o-mini`, etc.
+- **Anthropic**: `claude-sonnet-4-0`, `claude-3-5-haiku-latest`, etc.
+- **Google (GenAI)**: `gemini-2.5-pro`, `gemini-2.5-flash`, etc.
+
+## Configuration
+
+Create a `llm_mcp_config.json5` file:
+
+- [The configuration file format](https://github.com/hideya/mcp-client-langchain-ts/blob/main/llm_mcp_config.json5)
+  for MCP servers follows the same structure as
+  [Claude for Desktop](https://modelcontextprotocol.io/quickstart/user),
+  with one difference: the key name `mcpServers` has been changed
+  to `mcp_servers` to follow the snake_case convention
+  commonly used in JSON configuration files.
+- The file format is [JSON5](https://json5.org/),
+  where comments and trailing commas are allowed.
+- The format is further extended to replace `${...}` notations
+  with the values of corresponding environment variables.
+- Keep all the credentials and private info in the `.env` file
+  and refer to them with `${...}` notation as needed
+
+```json5
+{
+  "llm": {
+    "model_provider": "openai",
+    "model": "gpt-4.1-nano",
+    // model: "o4-mini",
+  },
+  
+  // "llm": {
+  //   "model_provider": "anthropic",
+  //   "model": "claude-3-5-haiku-latest",
+  //   // "model": "claude-sonnet-4-0",
+  // },
+
+  // "llm": {
+  //   "model_provider": "google_genai",
+  //   "model": "gemini-2.5-flash",
+  //   // "model": "gemini-2.5-pro",
+  // }
+
+  "example_queries": [
+    "Tell me how LLMs work in a few sentences",
+    "Are there any weather alerts in California?",
+    "Read the news headlines on bbc.com",
+  ],
+
+  "mcp_servers": {
+    // Local MCP server that uses `npx`
+    "weather": {
+      "command": "npx", 
+      "args": [ "-y", "@h1deya/mcp-server-weather" ]
+    },
+
+    // Another local server that uses `uvx`
+    "fetch": {
+      "command": "uvx",
+      "args": [ "mcp-server-fetch" ]
+    },
+
+    "brave-search": {
+      "command": "npx",
+      "args": [ "-y", "@modelcontextprotocol/server-brave-search" ],
+      "env": { "BRAVE_API_KEY": "${BRAVE_API_KEY}" }
+    },
+
+    // Remote MCP server via URL
+    // Auto-detection: tries Streamable HTTP first, falls back to SSE
+    "remote-mcp-server": {
+      "url": "https://api.example.com/..."
+    },
+
+    // Server with authentication
+    "github": {
+      "type": "http",  // recommended to specify the protocol explicitly when authentication is used
+      "url": "https://api.githubcopilot.com/mcp/",
+      "headers": {
+        "Authorization": "Bearer ${GITHUB_PERSONAL_ACCESS_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+### Environment Variables
+
+Create a `.env` file for API keys:
+
+```bash
+OPENAI_API_KEY=sk-ant-...
+ANTHROPIC_API_KEY=sk-proj-...
+GOOGLE_API_KEY=AI...
+
+# Other services as needed
+GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_...
+BRAVE_API_KEY=BSA...
+```
+
+## Popular MCP Servers to Try
+
+There are quite a few useful MCP servers already available:
+
+- [MCP Server Listing on the Official Site](https://github.com/modelcontextprotocol/servers?tab=readme-ov-file#model-context-protocol-servers)
+
+## Troubleshooting
+
+- Make sure your configuration and .env files are correct, especially the spelling of the API keys
+- Check the local MCP server logs
+- Use `--verbose` flag to view the detailed logs
+- Refer to [Debugging Section in MCP documentation](https://modelcontextprotocol.io/docs/tools/debugging)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Issues and pull requests welcome! This tool aims to make MCP server testing as simple as possible.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "dotenv/config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { createReactAgent } from "@langchain/langgraph/prebuilt";
+import { MemorySaver } from "@langchain/langgraph";
+import { HumanMessage } from "@langchain/core/messages";
+import { convertMcpToLangchainTools } from "@h1deya/langchain-mcp-tools";
+import { initChatModel } from "./init-chat-model.js";
+import { loadConfig } from "./load-config.js";
+import readline from "readline";
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import * as fs from "fs";
+import * as path from "path";
+// NOTE: without the following, I got this error:
+//   ReferenceError: WebSocket is not defined
+//     at <anonymous> (.../node_modules/@modelcontextprotocol/sdk/src/client/websocket.ts:29:26)
+import WebSocket from 'ws';
+global.WebSocket = WebSocket;
+// // Remote server connection testing
+// // Uncomment the following code snippet and add the configuration below to the configuration file.
+// //        weather: {
+// //            "url": "http://localhost:${SSE_SERVER_PORT}/sse"
+// //        },
+// // This leverages the Supergateway to make the Weather Studio MCP Server accessible as an SSE server.
+// import { startRemoteMcpServerLocally } from "./remote-server-utils.js";
+// const [sseServerProcess, sseServerPort] = await startRemoteMcpServerLocally(
+//   "SSE",  "npx -y @h1deya/mcp-server-weather");
+// process.env.SSE_SERVER_PORT = `${sseServerPort}`;
+// Constants
+const COLORS = {
+    YELLOW: "\x1b[33m",
+    CYAN: "\x1b[36m",
+    GREEN: "\x1b[32m",
+    RESET: "\x1b[0m"
+};
+const parseArguments = () => {
+    return yargs(hideBin(process.argv))
+        .options({
+        config: {
+            type: "string",
+            description: "Path to config file",
+            demandOption: false,
+            default: "llm_mcp_config.json5",
+            alias: "c",
+        },
+        verbose: {
+            type: "boolean",
+            description: "Run with verbose logging",
+            demandOption: false,
+            default: false,
+            alias: "v",
+        },
+        logDir: {
+            type: "string",
+            description: "Directory to store MCP server log files",
+            demandOption: false,
+            default: ".",
+            alias: "l",
+        },
+    })
+        .help()
+        .alias("help", "h")
+        .parseSync();
+};
+// Input handling
+const createReadlineInterface = () => {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+};
+const getInput = (rl, prompt) => {
+    return new Promise((resolve) => rl.question(prompt, resolve));
+};
+async function getUserQuery(rl, remainingQueries) {
+    const input = await getInput(rl, `${COLORS.YELLOW}Query: `);
+    process.stdout.write(COLORS.RESET);
+    const query = input.trim();
+    if (query.toLowerCase() === "quit" || query.toLowerCase() === "q") {
+        rl.close();
+        return undefined;
+    }
+    if (query === "") {
+        const exampleQuery = remainingQueries.shift();
+        if (!exampleQuery) {
+            console.log("\nPlease type a query, or 'quit' or 'q' to exit\n");
+            return await getUserQuery(rl, remainingQueries);
+        }
+        process.stdout.write("\x1b[1A\x1b[2K"); // Move up and clear the line
+        console.log(`${COLORS.YELLOW}Example Query: ${exampleQuery}${COLORS.RESET}`);
+        return exampleQuery;
+    }
+    return query;
+}
+// Conversation loop
+async function handleConversation(agent, remainingQueries) {
+    console.log("\nConversation started. Type 'quit' or 'q to end the conversation.\n");
+    if (remainingQueries && remainingQueries.length > 0) {
+        console.log("Exaample Queries (just type Enter to supply them one by one):");
+        remainingQueries.forEach(query => console.log(`- ${query}`));
+        console.log();
+    }
+    const rl = createReadlineInterface();
+    while (true) {
+        const query = await getUserQuery(rl, remainingQueries);
+        console.log();
+        if (!query) {
+            console.log(`${COLORS.CYAN}Goodbye!${COLORS.RESET}\n`);
+            return;
+        }
+        const agentFinalState = await agent.invoke({ messages: [new HumanMessage(query)] }, { configurable: { thread_id: "test-thread" } });
+        // the last message is an AIMessage
+        const result = agentFinalState.messages[agentFinalState.messages.length - 1].content;
+        const messageOneBefore = agentFinalState.messages[agentFinalState.messages.length - 2];
+        if (messageOneBefore.constructor.name === "ToolMessage") {
+            console.log(); // new line after tool call output
+        }
+        console.log(`${COLORS.CYAN}${result}${COLORS.RESET}\n`);
+    }
+}
+function addLogFileWatcher(logPath, serverName) {
+    const stats = fs.statSync(logPath);
+    let lastSize = stats.size;
+    const watcher = fs.watch(logPath, (eventType, filename) => {
+        if (eventType === 'change') {
+            // console.log(`*** file updated: "${filename}"`);
+            const stats = fs.statSync(logPath);
+            const currentSize = stats.size;
+            if (currentSize > lastSize) {
+                const buffer = Buffer.alloc(currentSize - lastSize);
+                const fd = fs.openSync(logPath, 'r');
+                fs.readSync(fd, buffer, 0, buffer.length, lastSize);
+                fs.closeSync(fd);
+                const newContent = buffer.toString();
+                console.log(`${COLORS.GREEN}[MCP Server Log: "${serverName}"]${COLORS.RESET}`, newContent.trim());
+                lastSize = currentSize;
+            }
+        }
+    });
+    return watcher;
+}
+// Application initialization
+async function initializeReactAgent(config, verbose, logDir) {
+    const llmProvider = config.llm.model_provider;
+    console.log("Initializing model...", config.llm, "\n");
+    const llmConfig = {
+        modelProvider: llmProvider,
+        model: config.llm.model,
+        temperature: config.llm.temperature,
+        maxTokens: config.llm.max_tokens,
+    };
+    const llm = initChatModel(llmConfig);
+    console.log(`Initializing ${Object.keys(config.mcp_servers).length} MCP server(s)...\n`);
+    // Ensure log directory exists
+    if (!fs.existsSync(logDir)) {
+        fs.mkdirSync(logDir, { recursive: true });
+        console.log(`Created log directory: ${logDir}`);
+    }
+    // Set a file descriptor to which MCP server's stderr is redirected
+    const openedLogFiles = {};
+    Object.keys(config.mcp_servers).forEach(serverName => {
+        if (config.mcp_servers[serverName].command) {
+            const logPath = path.join(logDir, `mcp-server-${serverName}.log`);
+            console.log(`Writing MCP server log file: ${logPath}`);
+            const logFd = fs.openSync(logPath, "w");
+            config.mcp_servers[serverName].stderr = logFd;
+            const watcher = addLogFileWatcher(logPath, serverName);
+            openedLogFiles[logPath] = { fd: logFd, watcher };
+        }
+    });
+    const toolsAndCleanup = await convertMcpToLangchainTools(config.mcp_servers, { llmProvider, logLevel: verbose ? "debug" : "info" });
+    const tools = toolsAndCleanup.tools;
+    const mcpCleanup = toolsAndCleanup.cleanup;
+    const agent = createReactAgent({
+        llm,
+        tools,
+        checkpointSaver: new MemorySaver(),
+    });
+    async function cleanup() {
+        await mcpCleanup();
+        // close log files and their watchers
+        Object.keys(openedLogFiles).forEach(logPath => {
+            try {
+                openedLogFiles[logPath].watcher.close();
+                fs.closeSync(openedLogFiles[logPath].fd);
+            }
+            catch (error) {
+                console.error(`Error closing log file: ${logPath}:`, error);
+            }
+        });
+    }
+    return { agent, cleanup };
+}
+// Main
+async function main() {
+    let mcpCleanup;
+    const argv = parseArguments();
+    try {
+        const config = loadConfig(argv.config);
+        const { agent, cleanup } = await initializeReactAgent(config, argv.verbose, argv.logDir);
+        mcpCleanup = cleanup;
+        await handleConversation(agent, config.example_queries ?? []);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            if (error.message.includes("Failed to load configuration")) {
+                console.error(error.message);
+                if (error.message.includes("ENOENT")) {
+                    console.error(`Make sure the config file "${argv.config}" is available`);
+                    console.error("Use the --config option to specify which JSON5 configuration file to read");
+                }
+            }
+            else if (error.message.includes("Failed to initialize chat model")) {
+                console.error(error.message);
+                console.error("Check the .env file for the API key settings");
+            }
+            else {
+                console.error(error.message);
+            }
+            return;
+        }
+        throw error;
+    }
+    finally {
+        await mcpCleanup?.();
+    }
+}
+// Application entry point with error handling
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/init-chat-model.d.ts

@@ -0,0 +1,11 @@
+import { BaseChatModel, BindToolsInput } from '@langchain/core/language_models/chat_models';
+interface ChatModelConfig {
+    modelProvider: string;
+    model: string;
+    temperature?: number;
+    maxTokens?: number;
+    tools?: BindToolsInput[];
+}
+export declare function initChatModel(config: ChatModelConfig): BaseChatModel;
+export {};
+//# sourceMappingURL=init-chat-model.d.ts.map

package/dist/init-chat-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-chat-model.d.ts","sourceRoot":"","sources":["../src/init-chat-model.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAK5F,UAAU,eAAe;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAyCpE"}

package/dist/init-chat-model.js

@@ -0,0 +1,37 @@
+import { ChatAnthropic } from '@langchain/anthropic';
+import { ChatOpenAI } from '@langchain/openai';
+import { ChatGoogleGenerativeAI } from "@langchain/google-genai";
+export function initChatModel(config) {
+    let model;
+    const { modelProvider, tools, ...llmConfig } = config;
+    try {
+        switch (modelProvider.toLowerCase()) {
+            case 'openai':
+                model = new ChatOpenAI(llmConfig);
+                break;
+            case 'anthropic':
+                model = new ChatAnthropic(llmConfig);
+                break;
+            case 'google_genai':
+                model = new ChatGoogleGenerativeAI(llmConfig);
+                break;
+            default:
+                throw new Error(`Unsupported model_provider: ${modelProvider}`);
+        }
+        if (typeof model?.bindTools === 'function') {
+            if (tools && tools.length > 0) {
+                // FIXME
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+                model = model.bindTools(tools);
+            }
+        }
+        else {
+            throw new Error(`Tool calling unsupported by model_provider: ${modelProvider}`);
+        }
+        return model;
+    }
+    catch (error) {
+        throw new Error(`Failed to initialize chat model: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+//# sourceMappingURL=init-chat-model.js.map

package/dist/init-chat-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-chat-model.js","sourceRoot":"","sources":["../src/init-chat-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAcjE,MAAM,UAAU,aAAa,CAAC,MAAuB;IACnD,IAAI,KAAoB,CAAC;IAEzB,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,SAAS,EAAE,GAAG,MAAM,CAAC;IAEtD,IAAI,CAAC;QACH,QAAQ,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;YACpC,KAAK,QAAQ;gBACX,KAAK,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;gBAClC,MAAM;YAER,KAAK,WAAW;gBACd,KAAK,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;gBACrC,MAAM;YAER,KAAK,cAAc;gBACjB,KAAK,GAAG,IAAI,sBAAsB,CAAC,SAAS,CAAC,CAAC;gBAC9C,MAAM;YAER;gBACE,MAAM,IAAI,KAAK,CACb,+BAA+B,aAAa,EAAE,CAC/C,CAAC;QACN,CAAC;QAED,IAAI,OAAO,KAAK,EAAE,SAAS,KAAK,UAAU,EAAE,CAAC;YAC3C,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,QAAQ;gBACR,sEAAsE;gBACtE,KAAK,GAAI,KAAiC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,+CAA+C,aAAa,EAAE,CAC/D,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAClH,CAAC;AACH,CAAC"}

package/dist/load-config.d.ts

@@ -0,0 +1,37 @@
+export interface LLMConfig {
+    model_provider: string;
+    model: string;
+    temperature?: number;
+    max_tokens?: number;
+    max_completion_tokens?: number;
+}
+export interface CommandBasedConfig {
+    url?: never;
+    transport?: string;
+    type?: string;
+    headers?: never;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    stderr?: number;
+}
+export interface UrlBasedConfig {
+    url: string;
+    transport?: string;
+    type?: string;
+    headers?: Record<string, string>;
+    command?: never;
+    args?: never;
+    env?: never;
+    stderr?: never;
+}
+export type MCPServerConfig = CommandBasedConfig | UrlBasedConfig;
+export interface Config {
+    llm: LLMConfig;
+    example_queries?: string[];
+    mcp_servers: {
+        [key: string]: MCPServerConfig;
+    };
+}
+export declare function loadConfig(path: string): Config;
+//# sourceMappingURL=load-config.d.ts.map

package/dist/load-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../src/load-config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAElE,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,SAAS,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE;QACX,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;KAChC,CAAA;CACF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB/C"}

package/dist/load-config.js

@@ -0,0 +1,123 @@
+import JSON5 from 'json5';
+import { readFileSync } from 'fs';
+export function loadConfig(path) {
+    try {
+        let json5Str = readFileSync(path, 'utf-8');
+        // Replace environment variables in the format ${VAR_NAME} with their values
+        Object.entries(process.env).forEach(([key, value]) => {
+            json5Str = json5Str.replace(`\${${key}}`, value || '');
+        });
+        const config = JSON5.parse(json5Str);
+        // Validate required fields
+        validateConfig(config);
+        return config;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to load configuration from "${path}": ${error.message}`);
+        }
+        throw error;
+    }
+}
+function validateConfig(config) {
+    if (typeof config !== 'object' || config === null) {
+        throw new Error('Configuration must be an object');
+    }
+    if (!('llm' in config)) {
+        throw new Error('LLM configuration is required');
+    }
+    validateLLMConfig(config.llm);
+    if ('example_queries' in config) {
+        if (!Array.isArray(config.example_queries)) {
+            throw new Error('example_queries must be an array if provided');
+        }
+        if (config.example_queries.some((query) => typeof query !== 'string')) {
+            throw new Error('All example queries must be strings');
+        }
+    }
+    if (!('mcp_servers' in config)) {
+        throw new Error('mcp_servers configuration is required');
+    }
+    if (typeof config.mcp_servers !== 'object' || config.mcp_servers === null) {
+        throw new Error('mcp_servers must be an object');
+    }
+    Object.entries(config.mcp_servers).forEach(([key, value]) => {
+        try {
+            validateMCPServerConfig(value);
+        }
+        catch (error) {
+            throw new Error(`Invalid configuration for MCP server "${key}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+    });
+}
+function validateLLMConfig(llmConfig) {
+    if (typeof llmConfig !== 'object' || llmConfig === null) {
+        throw new Error('LLM configuration must be an object');
+    }
+    if (!('model_provider' in llmConfig) || typeof llmConfig.model_provider !== 'string') {
+        throw new Error('LLM model_provider must be a string');
+    }
+    if (!('model' in llmConfig) || typeof llmConfig.model !== 'string') {
+        throw new Error('LLM model must be a string');
+    }
+    if ('temperature' in llmConfig && typeof llmConfig.temperature !== 'number') {
+        throw new Error('LLM temperature must be a number if provided');
+    }
+    if ('max_tokens' in llmConfig && typeof llmConfig.max_tokens !== 'number') {
+        throw new Error('LLM max_tokens must be a number if provided');
+    }
+    if ('max_completion_tokens' in llmConfig && typeof llmConfig.max_completion_tokens !== 'number') {
+        throw new Error('LLM max_completion_tokens must be a number if provided');
+    }
+}
+function validateMCPServerConfig(serverConfig) {
+    if (typeof serverConfig !== 'object' || serverConfig === null) {
+        throw new Error('MCP server configuration must be an object');
+    }
+    if (!('url' in serverConfig) && !('command' in serverConfig)) {
+        throw new Error('MCP server configuration must include command or url');
+    }
+    if ('url' in serverConfig && typeof serverConfig.url !== 'string') {
+        throw new Error('MCP server url must be a string');
+    }
+    if ('transport' in serverConfig && typeof serverConfig.transport !== 'string') {
+        throw new Error('MCP server transport must be a string');
+    }
+    if ('type' in serverConfig && typeof serverConfig.type !== 'string') {
+        throw new Error('MCP server type must be a string');
+    }
+    if ('headers' in serverConfig && serverConfig.headers !== undefined) {
+        if (typeof serverConfig.headers !== 'object' || serverConfig.headers === null) {
+            throw new Error('MCP server headers must be an object if provided');
+        }
+        // Validate that all env values are strings
+        for (const [, value] of Object.entries(serverConfig.headers)) {
+            if (typeof value !== 'string') {
+                throw new Error('All MCP server headers values must be strings');
+            }
+        }
+    }
+    if ('command' in serverConfig && typeof serverConfig.command !== 'string') {
+        throw new Error('MCP server command must be a string');
+    }
+    if ('args' in serverConfig) {
+        if (!Array.isArray(serverConfig.args)) {
+            throw new Error('MCP server args must be an array');
+        }
+        if (serverConfig.args.some((arg) => typeof arg !== 'string')) {
+            throw new Error('All MCP server args must be strings');
+        }
+    }
+    if ('env' in serverConfig && serverConfig.env !== undefined) {
+        if (typeof serverConfig.env !== 'object' || serverConfig.env === null) {
+            throw new Error('MCP server env must be an object if provided');
+        }
+        // Validate that all env values are strings
+        for (const [, value] of Object.entries(serverConfig.env)) {
+            if (typeof value !== 'string') {
+                throw new Error('All MCP server env values must be strings');
+            }
+        }
+    }
+}
+//# sourceMappingURL=load-config.js.map

package/dist/load-config.js.map

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

package/dist/remote-server-utils.d.ts

@@ -0,0 +1,18 @@
+import * as child_process from 'child_process';
+/**
+ * Find and return a free port on localhost.
+ * @returns A Promise resolving to an available port number
+ */
+export declare function findFreePort(): Promise<number>;
+/**
+ * Start an MCP server process via supergateway with the specified transport
+ * type. Supergateway runs MCP stdio-based servers over SSE or WebSockets
+ * and is used here to run local SSE/WS servers for connection testing.
+ * Ref: https://github.com/supercorp-ai/supergateway
+ *
+ * @param transportType - The transport type, either 'SSE' or 'WS'
+ * @param mcpServerRunCommand - The command to run the MCP server
+ * @returns A Promise resolving to [serverProcess, serverPort]
+ */
+export declare function startRemoteMcpServerLocally(transportType: string, mcpServerRunCommand: string): Promise<[child_process.ChildProcess, number]>;
+//# sourceMappingURL=remote-server-utils.d.ts.map

package/dist/remote-server-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-server-utils.d.ts","sourceRoot":"","sources":["../src/remote-server-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,eAAe,CAAC;AAO/C;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAYpD;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE,MAAM,EACrB,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CA4E/C"}

package/dist/remote-server-utils.js

@@ -0,0 +1,91 @@
+import * as child_process from 'child_process';
+import * as net from 'net';
+// NOTE: Hard-coded dependency on the Supergateway message
+// to easily identify the end of initialization.
+const SUPERGATEWAY_READY_MESSAGE = "[supergateway] Listening on port";
+/**
+ * Find and return a free port on localhost.
+ * @returns A Promise resolving to an available port number
+ */
+export async function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.unref();
+        server.on('error', reject);
+        server.listen(0, () => {
+            const port = server.address().port;
+            server.close(() => {
+                resolve(port);
+            });
+        });
+    });
+}
+/**
+ * Start an MCP server process via supergateway with the specified transport
+ * type. Supergateway runs MCP stdio-based servers over SSE or WebSockets
+ * and is used here to run local SSE/WS servers for connection testing.
+ * Ref: https://github.com/supercorp-ai/supergateway
+ *
+ * @param transportType - The transport type, either 'SSE' or 'WS'
+ * @param mcpServerRunCommand - The command to run the MCP server
+ * @returns A Promise resolving to [serverProcess, serverPort]
+ */
+export async function startRemoteMcpServerLocally(transportType, mcpServerRunCommand) {
+    const serverPort = await findFreePort();
+    // Base command common to both server types
+    const command = [
+        "npx",
+        "-y",
+        "supergateway",
+        "--stdio",
+        mcpServerRunCommand,
+        "--port", serverPort.toString(),
+    ];
+    // Add transport-specific arguments
+    if (transportType.toLowerCase() === 'sse') {
+        command.push("--baseUrl", `http://localhost:${serverPort}`, "--ssePath", "/sse", "--messagePath", "/message");
+    }
+    else if (transportType.toLowerCase() === 'ws') {
+        command.push("--outputTransport", "ws", "--messagePath", "/message");
+    }
+    else {
+        throw new Error(`Unsupported transport type: ${transportType}`);
+    }
+    // Start the server process with stdout/stderr piped
+    const serverProcess = child_process.spawn(command[0], command.slice(1), {
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    console.log(`Starting ${transportType.toUpperCase()} MCP Server Process with PID: ${serverProcess.pid}`);
+    // Return a promise that resolves when the server is ready
+    return new Promise((resolve, reject) => {
+        // Set a reasonable timeout as fallback (30 seconds)
+        const timeoutId = setTimeout(() => {
+            reject(new Error(`Timed out waiting for ${transportType.toUpperCase()} server to start`));
+        }, 30000);
+        // Listen for the specific log message that indicates server is ready
+        serverProcess.stdout?.on('data', (data) => {
+            const output = data.toString();
+            console.log(output); // Still log the output to console
+            if (output.includes(SUPERGATEWAY_READY_MESSAGE)) {
+                clearTimeout(timeoutId);
+                console.log(`${transportType.toUpperCase()} MCP Server is ready on port ${serverPort}`);
+                resolve([serverProcess, serverPort]);
+            }
+        });
+        // Handle errors
+        serverProcess.stderr?.on('data', (data) => {
+            console.error(`Server error: ${data}`);
+        });
+        serverProcess.on('error', (err) => {
+            clearTimeout(timeoutId);
+            reject(new Error(`Failed to start server: ${err.message}`));
+        });
+        serverProcess.on('exit', (code) => {
+            if (code !== 0 && code !== null) {
+                clearTimeout(timeoutId);
+                reject(new Error(`Server process exited with code ${code}`));
+            }
+        });
+    });
+}
+//# sourceMappingURL=remote-server-utils.js.map

package/dist/remote-server-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-server-utils.js","sourceRoot":"","sources":["../src/remote-server-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAE3B,0DAA0D;AAC1D,gDAAgD;AAChD,MAAM,0BAA0B,GAAG,kCAAkC,CAAA;AAErE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE;YACpB,MAAM,IAAI,GAAI,MAAM,CAAC,OAAO,EAAsB,CAAC,IAAI,CAAC;YACxD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,aAAqB,EACrB,mBAA2B;IAE3B,MAAM,UAAU,GAAG,MAAM,YAAY,EAAE,CAAC;IAExC,2CAA2C;IAC3C,MAAM,OAAO,GAAG;QACd,KAAK;QACL,IAAI;QACJ,cAAc;QACd,SAAS;QACT,mBAAmB;QACnB,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE;KAChC,CAAC;IAEF,mCAAmC;IACnC,IAAI,aAAa,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1C,OAAO,CAAC,IAAI,CACV,WAAW,EAAE,oBAAoB,UAAU,EAAE,EAC7C,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,UAAU,CAC5B,CAAC;IACJ,CAAC;SAAM,IAAI,aAAa,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,CACV,mBAAmB,EAAE,IAAI,EACzB,eAAe,EAAE,UAAU,CAC5B,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,+BAA+B,aAAa,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,oDAAoD;IACpD,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CACvC,OAAO,CAAC,CAAC,CAAC,EACV,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAChB;QACE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CACF,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,YAAY,aAAa,CAAC,WAAW,EAAE,iCAAiC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC;IAEzG,0DAA0D;IAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,oDAAoD;QACpD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,aAAa,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAC5F,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,qEAAqE;QACrE,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,kCAAkC;YAEvD,IAAI,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;gBAChD,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,WAAW,EAAE,gCAAgC,UAAU,EAAE,CAAC,CAAC;gBACxF,OAAO,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,gBAAgB;QAChB,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxC,OAAO,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAChC,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAChC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAChC,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@h1deya/mcp-client-cli",
+  "version": "0.3.0",
+  "description": "Simple MCP Client to quickly test and explore MCP servers from the command line",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "client",
+    "cli",
+    "langchain",
+    "tools",
+    "typescript",
+    "simple",
+    "quick",
+    "explore",
+    "try",
+    "test"
+  ],
+  "author": "hideya kawahara",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hideya/mcp-client-langchain-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hideya/mcp-client-langchain-ts/issues"
+  },
+  "bin": {
+    "mcp-client-cli": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "module",
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "start:h": "tsx src/index.ts -h",
+    "start:v": "tsx src/index.ts -v",
+    "dev": "tsx watch src/index.ts",
+    "lint": "eslint src",
+    "clean": "git clean -fdxn -e .env && read -p 'OK?' && git clean -fdx -e .env",
+    "test": "echo \"No tests specified\" && exit 0",
+    "build": "tsc && chmod +x dist/index.js",
+    "publish:prepare": "npm run clean && npm install && npm run build",
+    "publish:test": "npm run publish:prepare && npm publish --access=public --dry-run",
+    "publish:do": "npm run publish:prepare && npm publish --access=public"
+  },
+  "dependencies": {
+    "@h1deya/langchain-mcp-tools": "^0.3.0",
+    "@langchain/anthropic": "^0.3.11",
+    "@langchain/core": "^0.3.61",
+    "@langchain/google-genai": "^0.2.12",
+    "@langchain/langgraph": "^0.3.6",
+    "@langchain/openai": "^0.3.16",
+    "@types/yargs": "^17.0.33",
+    "dotenv": "^16.4.7",
+    "json5": "^2.2.3",
+    "ws": "^8.18.2",
+    "yargs": "^17.7.2",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "@types/node": "^22.10.5",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.19.0",
+    "@typescript-eslint/parser": "^8.19.0",
+    "eslint": "^9.17.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.19.0"
+  }
+}