@victox/hello-stdio 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 victox
+
+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,93 @@
+# @victox/hello-stdio
+
+An MCP server (stdio) that exposes two demo tools:
+
+- `hello1`: generate a random greeting
+- `hello2`: generate a greeting for a given name
+
+## Requirements
+
+- Node.js >= 18
+
+## Install
+
+### Global (recommended)
+
+```bash
+npm i -g @victox/hello-stdio
+```
+
+### Project-local
+
+```bash
+npm i @victox/hello-stdio
+```
+
+## Run
+
+### If installed globally
+
+```bash
+hello-mcp-server
+```
+
+### If installed locally
+
+```bash
+npx -y @victox/hello-stdio hello-mcp-server
+```
+
+This is a **stdio** MCP server: it communicates via stdin/stdout and is meant to be launched by an MCP host.
+
+## Use with OpenCode
+
+Add to `.opencode/opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "hello-stdio": {
+      "type": "stdio",
+      "command": "hello-mcp-server",
+      "args": [],
+      "enabled": true
+    }
+  }
+}
+```
+
+If you did not install globally, use `npx` instead:
+
+```json
+{
+  "mcp": {
+    "hello-stdio": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@victox/hello-stdio", "hello-mcp-server"],
+      "enabled": true
+    }
+  }
+}
+```
+
+## Tool API
+
+### `hello1`
+
+- input: none
+- output: text greeting
+
+### `hello2`
+
+- input:
+  - `name` (string, required, non-empty)
+- output: text greeting with `name`
+
+## Troubleshooting
+
+- If publish/install works but the host can't start the server, verify the executable exists:
+  - global: `which hello-mcp-server`
+  - local: `npx -y @victox/hello-stdio hello-mcp-server`
+- If your host doesn't support stdio MCP servers, use the HTTP/SSE server packages instead.

package/dist/cli.mjs

@@ -1,4 +1,2 @@
 #!/usr/bin/env node
-import "./index.mjs";
-
-export {  };
+import"./index.mjs";export{};

package/dist/index.mjs

@@ -1,59 +1,2 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import * as z from "zod/v4";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-
-//#region ../hello-lib/dist/index.js
-const GREETINGS = [
-	"Hello!",
-	"Hi there!",
-	"Hey!",
-	"Howdy!",
-	"Good day!",
-	"Greetings!"
-];
-function pickRandom(items) {
-	if (items.length === 0) throw new Error("pickRandom: empty list");
-	return items[Math.floor(Math.random() * items.length)];
-}
-function registerHelloTools(server) {
-	server.registerTool("hello1", { description: "Generate a random greeting." }, async () => {
-		return { content: [{
-			type: "text",
-			text: pickRandom(GREETINGS)
-		}] };
-	});
-	server.registerTool("hello2", {
-		description: "Generate a greeting addressed to a provided name.",
-		inputSchema: { name: z.string().min(1).describe("Name to greet.") }
-	}, async ({ name }) => {
-		return { content: [{
-			type: "text",
-			text: `${pickRandom(GREETINGS)} ${name}`
-		}] };
-	});
-}
-function createHelloServer(info, options) {
-	const server = new McpServer(info, options);
-	registerHelloTools(server);
-	return server;
-}
-
-//#endregion
-//#region src/index.ts
-async function main() {
-	const mcpServer = createHelloServer({
-		name: "hello-mcp-server",
-		version: "0.1.0"
-	});
-	const transport = new StdioServerTransport();
-	await mcpServer.connect(transport);
-}
-if (process.stdin.isTTY) process.stdin.resume();
-main().catch((err) => {
-	const message = err instanceof Error ? err.stack ?? err.message : String(err);
-	process.stderr.write(message + "\n");
-	process.exit(1);
-});
-
-//#endregion
-export {  };
+import{McpServer as e}from"@modelcontextprotocol/sdk/server/mcp.js";import*as t from"zod/v4";import{StdioServerTransport as n}from"@modelcontextprotocol/sdk/server/stdio.js";const r=[`Hello!`,`Hi there!`,`Hey!`,`Howdy!`,`Good day!`,`Greetings!`];function i(e){if(e.length===0)throw Error(`pickRandom: empty list`);return e[Math.floor(Math.random()*e.length)]}function a(e){e.registerTool(`hello1`,{description:`Generate a random greeting.`},async()=>({content:[{type:`text`,text:i(r)}]})),e.registerTool(`hello2`,{description:`Generate a greeting addressed to a provided name.`,inputSchema:{name:t.string().min(1).describe(`Name to greet.`)}},async({name:e})=>({content:[{type:`text`,text:`${i(r)} ${e}`}]}))}function o(t,n){let r=new e(t,n);return a(r),r}async function s(){let e=o({name:`hello-mcp-server`,version:`0.1.0`}),t=new n;await e.connect(t)}process.stdin.isTTY&&process.stdin.resume(),s().catch(e=>{let t=e instanceof Error?e.stack??e.message:String(e);process.stderr.write(t+`
+`),process.exit(1)});export{};

package/package.json

@@ -1,7 +1,20 @@
 {
   "name": "@victox/hello-stdio",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": false,
+  "description": "MCP stdio server exposing hello1/hello2 demo tools",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "opencode",
+    "stdio",
+    "agent",
+    "tools"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
   "type": "module",
   "main": "dist/index.mjs",
   "types": "dist/index.d.mts",
@@ -9,17 +22,22 @@
     "hello-mcp-server": "dist/cli.mjs"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "exports": {
     ".": "./dist/index.mjs",
     "./cli": "./dist/cli.mjs",
     "./package.json": "./package.json"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsdown",
     "prepack": "pnpm run build",
-    "start": "node dist/index.js"
+    "start": "node dist/index.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",