domains-mcp 0.1.0 → 0.1.1

package/README.md

@@ -1,5 +1,8 @@
 # domains-mcp
 
+[![npm version](https://img.shields.io/npm/v/domains-mcp.svg)](https://www.npmjs.com/package/domains-mcp)
+[![license](https://img.shields.io/npm/l/domains-mcp.svg)](./LICENSE)
+
 An MCP server that lets Claude (and other agents) check **domain availability**, look up
 registration details, and suggest available names across TLDs.
 
@@ -18,17 +21,20 @@ with a port-43 **WHOIS** fallback. No API keys, no accounts, no paid services.
 Each result is one of `available`, `registered`, or `unknown`. `unknown` means no source could
 answer definitively — the server never guesses an answer.
 
-## Install & build
+## Install
+
+The package is published on npm: **[domains-mcp](https://www.npmjs.com/package/domains-mcp)**.
+
+Run it directly with `npx` (no install needed):
 
 ```bash
-npm install
-npm run build
+npx domains-mcp
 ```
 
-## Quick smoke test (no MCP client needed)
+…or install it globally:
 
 ```bash
-node dist/cli-smoke.js google.com some-free-name-12345.com github.io münchen.de
+npm install -g domains-mcp
 ```
 
 ## Use with Claude
@@ -39,8 +45,8 @@ Add to your MCP client configuration (e.g. Claude Desktop's `claude_desktop_conf
 {
   "mcpServers": {
     "domains": {
-      "command": "node",
-      "args": ["/absolute/path/to/domains-mcp/dist/index.js"]
+      "command": "npx",
+      "args": ["-y", "domains-mcp"]
     }
   }
 }
@@ -49,6 +55,21 @@ Add to your MCP client configuration (e.g. Claude Desktop's `claude_desktop_conf
 Then ask things like: *"Is acme-robotics.com available?"*, *"Check these five domains for me,"* or
 *"Suggest available domains for the name 'lumina'."*
 
+## Local development
+
+```bash
+git clone https://github.com/fulldev-pl1/domains-mcp.git
+cd domains-mcp
+npm install
+npm run build
+```
+
+Quick smoke test (no MCP client needed):
+
+```bash
+npm run check -- google.com some-free-name-12345.com github.io münchen.de
+```
+
 ## Configuration (all optional)
 
 | Variable | Purpose | Default |
@@ -67,6 +88,8 @@ Then ask things like: *"Is acme-robotics.com available?"*, *"Check these five do
    IANA for the TLD's WHOIS server, queries it, and pattern-matches the response.
 4. Results are cached briefly to cut latency and respect registry rate limits.
 
+See [DESIGN.md](DESIGN.md) for the full architecture and the rationale behind these decisions.
+
 ## Known limitations
 
 Some ccTLD WHOIS servers (e.g. DENIC for `.de`) return restricted or unusually formatted

package/dist/index.js

@@ -1,14 +1,18 @@
 #!/usr/bin/env node
+import { readFileSync } from "node:fs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { loadConfig } from "./config.js";
 import { DomainService } from "./service.js";
+// Single source of truth for the version: read it from package.json at runtime.
+// At runtime this file lives in dist/, so package.json sits one level up.
+const { version } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 const config = loadConfig();
 const service = new DomainService(config);
 const server = new McpServer({
     name: "domains-mcp",
-    version: "0.1.0",
+    version,
 });
 function statusLine(r) {
     const name = r.domainUnicode !== r.domain ? `${r.domainUnicode} (${r.domain})` : r.domain;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domains-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for checking domain availability via RDAP (with WHOIS fallback). Free, no API keys.",
   "type": "module",
   "bin": {