@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)

npm i -g @victox/hello-stdio

Project-local

npm i @victox/hello-stdio

Run

If installed globally

hello-mcp-server

If installed locally

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:

{
  "$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:

{
  "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.