@sgpdirectory/mcp 1.3.0 → 1.3.1

package/.mise.toml

@@ -0,0 +1,3 @@
+[tools]
+node = "22.16.0"
+pnpm = "10.10.0"

package/README.md

@@ -50,21 +50,21 @@ If your proxy is behind an access token, you can pass it via `SGP_DIRECTORY_API_
 1. **Login to NPM**
    Run the login command and follow the prompts. You need to be a part of the `@sgpdirectory` org.
    ```bash
-   npm login
+   pnpm login
    ```
 
 2. **Publish the package**
    Run the following inside your wrapper directory:
    ```bash
-   npm publish --access public
+   pnpm publish --access public
    ```
 
 ## Local Testing
 If you have cloned the repository locally, you can run:
 
 ```bash
-npm install
-npm start
+pnpm install
+pnpm start
 ```
 
 This will launch the proxy and wait for standard `stdio` JSON-RPC messages.

package/package.json

@@ -1,14 +1,8 @@
 {
   "name": "@sgpdirectory/mcp",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Singapore business directory. Search companies, UENs, and SSIC industry classifications.",
   "main": "index.js",
-  "scripts": {
-    "start": "node ./index.js",
-    "test": "node scripts/smoke-test.js",
-    "version": "node scripts/sync-version.js",
-    "deploy": "sh scripts/3-login-dns.sh && sh scripts/4-publish.sh"
-  },
   "keywords": [
     "mcp",
     "mcp-server",
@@ -31,5 +25,16 @@
   "publishConfig": {
     "access": "public"
   },
-  "mcpName": "com.sgpdirectory/mcp"
+  "mcpName": "com.sgpdirectory/mcp",
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1"
+  },
+  "scripts": {
+    "start": "node ./index.js",
+    "version": "node scripts/sync-version.js",
+    "deploy:npm": "pnpm login && pnpm publish --access public --no-git-checks",
+    "deploy:mcp": "sh scripts/3-publish-mcp.sh",
+    "test:integration": "node scripts/integration-test.js",
+    "test:smoke": "node scripts/smoke-test.js"
+  }
 }

package/scripts/0-install-mcp-publisher.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# Install the latest mcp-publisher tool from modelcontextprotocol/registry
+set -e
+
+# Detect OS and architecture
+OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+ARCH=$(uname -m)
+
+if [ "$ARCH" = "x86_64" ]; then
+    ARCH="amd64"
+elif [ "$ARCH" = "aarch64" ] || [ "$ARCH" = "arm64" ]; then
+    ARCH="arm64"
+else
+    echo "Unsupported architecture: $ARCH"
+    exit 1
+fi
+
+TAR_GZ_NAME="mcp-publisher_${OS}_${ARCH}.tar.gz"
+DOWNLOAD_URL="https://github.com/modelcontextprotocol/registry/releases/latest/download/$TAR_GZ_NAME"
+
+echo "Downloading $TAR_GZ_NAME..."
+TMP_DIR=$(mktemp -d)
+curl -sL -o "$TMP_DIR/$TAR_GZ_NAME" "$DOWNLOAD_URL"
+
+echo "Extracting..."
+tar -xzf "$TMP_DIR/$TAR_GZ_NAME" -C "$TMP_DIR"
+
+INSTALL_DIR="$HOME/.local/bin"
+mkdir -p "$INSTALL_DIR"
+echo "Installing mcp-publisher to $INSTALL_DIR..."
+mv "$TMP_DIR/mcp-publisher" "$INSTALL_DIR/"
+chmod +x "$INSTALL_DIR/mcp-publisher"
+
+# Cleanup
+rm -rf "$TMP_DIR"
+
+echo "mcp-publisher has been installed."
+if [[ ":$PATH:" != *":$INSTALL_DIR:"* ]]; then
+    echo ""
+    echo "WARNING: $INSTALL_DIR is not in your PATH."
+    echo "To use the mcp-publisher command globally, please add the following line to your shell profile (~/.bashrc, ~/.zshrc, etc.):"
+    echo ""
+    echo "export PATH=\"\$PATH:$INSTALL_DIR\""
+fi

package/scripts/{3-login-dns.sh → 3-publish-mcp.sh}

@@ -5,8 +5,13 @@ KEY_FILE="/tmp/sgpdirectory-mcp-dns-key.pem"
 # Generate keypair
 #openssl genpkey -algorithm Ed25519 -out $KEY_FILE
 
-# Get public key for DNS record
+# Get public key for DNS record, add to your DNS provider
 #echo "$DOMAIN. IN TXT \"v=MCPv1; k=ed25519; p=$(openssl pkey -in $KEY_FILE -pubout -outform DER | tail -c 32 | base64)\""
 
-# Add the TXT record to your DNS, then login
+# Login to MCP Registry
 mcp-publisher login dns --domain $DOMAIN --private-key $(openssl pkey -in $KEY_FILE -noout -text | grep -A3 "priv:" | tail -n +2 | tr -d ' :\n')
+
+# Publish to MCP Registry
+echo "Publishing to registry.modelcontextprotocol.io..."
+# mcp-publisher publish uses the server.json file to update the MCP registry
+mcp-publisher publish

package/scripts/integration-test.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/**
+ * @sgpdirectory/mcp integration test
+ * Uses the official MCP SDK to verify the local server functionality.
+ */
+const { Client } = require("@modelcontextprotocol/sdk/client/index.js");
+const { StdioClientTransport } = require("@modelcontextprotocol/sdk/client/stdio.js");
+const path = require('path');
+
+async function runIntegrationTest() {
+    const scriptPath = path.resolve(__dirname, '../index.js');
+
+    console.log('--- Starting SGP Directory MCP Integration Test (SDK Mode) ---');
+
+    const transport = new StdioClientTransport({
+        command: "node",
+        args: [scriptPath],
+        env: {
+            ...process.env,
+            SGP_DIRECTORY_API_KEY: process.env.SGP_DIRECTORY_API_KEY || 'test-integration-key'
+        }
+    });
+
+    const client = new Client({
+        name: "integration-test-client",
+        version: "1.3.1"
+    }, {
+        capabilities: {}
+    });
+
+    try {
+        console.log("1. Connecting to local MCP server...");
+        await client.connect(transport);
+        console.log("✅ Connected");
+
+        console.log("2. Listing tools...");
+        const toolsRes = await client.listTools();
+        const tools = toolsRes.tools || [];
+        console.log(`✅ Found ${tools.length} tools: ${tools.map(t => t.name).join(', ')}`);
+
+        if (tools.length === 0) throw new Error("No tools found!");
+
+        console.log('3. Calling "search_entities" with query "Google"...');
+        const result = await client.callTool({
+            name: "search_entities",
+            arguments: { query: "Google", limit: 1 }
+        });
+
+        if (result.isError) {
+            throw new Error(`Tool call returned error: ${JSON.stringify(result.content)}`);
+        }
+
+        console.log('✅ Search call responded successfully');
+
+        console.log('\n✨ ALL INTEGRATION TESTS PASSED');
+        await client.close();
+        process.exit(0);
+
+    } catch (err) {
+        console.error(`\n❌ INTEGRATION TEST FAILED: ${err.message}`);
+        process.exit(1);
+    }
+}
+
+runIntegrationTest();

package/scripts/smoke-test.js

@@ -1,93 +1,75 @@
 #!/usr/bin/env node
 /**
  * @sgpdirectory/mcp smoke test
- * This script launches the MCP standard-io proxy and sends a JSON-RPC 'initialize' request
- * to verify that the server starts up and responds correctly.
+ * Uses the official MCP SDK to verify the published package.
  */
-const { spawn } = require('child_process');
-const path = require('path');
-
-const scriptPath = path.resolve(__dirname, '../index.js');
-
-console.log('--- Starting SGP Directory MCP Smoke Test ---');
-
-// We use 'pipe' for all stdio to capture and send data programmatically
-const server = spawn('node', [scriptPath], {
-    stdio: ['pipe', 'pipe', 'pipe'],
-    env: {
-        ...process.env,
-        // Add a test API key to ensure the logic for appending headers works
-        SGP_DIRECTORY_API_KEY: 'test-smoke-key'
+const { Client } = require("@modelcontextprotocol/sdk/client/index.js");
+const { StdioClientTransport } = require("@modelcontextprotocol/sdk/client/stdio.js");
+const pkg = require('../package.json');
+
+async function runSmokeTest() {
+    // 1. Determine version (arg or package.json)
+    const specifiedVersion = process.argv[2];
+    const version = specifiedVersion || pkg.version;
+    const packageName = pkg.name;
+
+    console.log(`--- Starting SGP Directory MCP Smoke Test (SDK Mode) ---`);
+    console.log(`Testing package: ${packageName}@${version}`);
+
+    // We use the canonical way to run a binary when it doesn't match the package name:
+    // npx -y --package @scope/pkg@version -- binary-name
+    const transport = new StdioClientTransport({
+        command: "npx",
+        args: [
+            "-y",
+            "--package", `${packageName}@${version}`,
+            "--",
+            "sgpdirectory-mcp"
+        ],
+        env: {
+            ...process.env,
+            SGP_DIRECTORY_API_KEY: 'test-smoke-key'
+        }
+    });
+
+    if (process.env.DEBUG) {
+        transport.onmessage = (msg) => console.log(`[Transport JSON-RPC]: ${JSON.stringify(msg)}`);
     }
-});
-
-let output = '';
-let responseFound = false;
-
-server.stdout.on('data', (data) => {
-    const str = data.toString();
-    output += str;
-
-    // Just log a snippet if too long
-    console.log(`[STDOUT snippet]: ${str.slice(0, 200).trim()}${str.length > 200 ? '...' : ''}`);
 
-    // Check for successful JSON-RPC initialization response
-    if (output.includes('"result":') || output.includes('"id":1')) {
-        responseFound = true;
-        // If we got the response, we can stop the test early
-        cleanup();
-    }
-});
+    const client = new Client({
+        name: "smoke-test-client",
+        version: "1.0.0"
+    }, {
+        capabilities: {}
+    });
 
-server.stderr.on('data', (data) => {
-    console.error('[STDERR]:', data.toString().trim());
-});
+    try {
+        console.log("Connecting to MCP server via npx...");
 
-const initializeRequest = JSON.stringify({
-    jsonrpc: '2.0',
-    id: 1,
-    method: 'initialize',
-    params: {
-        protocolVersion: '2024-11-05',
-        capabilities: {},
-        clientInfo: { name: 'smoke-test', version: '1.0.1' }
-    }
-}) + '\n';
+        // Timeout for the whole connection process
+        const timeout = setTimeout(() => {
+            console.error("❌ Error: Smoke test timed out after 15s");
+            process.exit(1);
+        }, 15000);
 
-console.log('Sending initialize request to local proxy...');
-server.stdin.write(initializeRequest);
+        await client.connect(transport);
+        clearTimeout(timeout);
 
-let isCleanedUp = false;
-function cleanup() {
-    if (isCleanedUp) return;
-    isCleanedUp = true;
+        console.log("✅ Successfully connected and initialized");
 
-    clearTimeout(timeout);
-    server.kill();
+        // Verify we can at least list tools (standard health check)
+        const tools = await client.listTools();
+        console.log(`✅ Server reported ${tools.tools.length} available tools`);
 
-    if (responseFound) {
-        console.log('\n✅ SMOKE TEST PASSED: SGP Directory MCP proxy responded to initialize request.');
+        console.log("\n✨ SMOKE TEST PASSED: Package is functional on the registry.");
+        await client.close();
         process.exit(0);
-    } else {
-        console.error('\n❌ SMOKE TEST FAILED: SGP Directory MCP proxy did not respond with a valid JSON-RPC result.');
+
+    } catch (error) {
+        console.error("\n❌ SMOKE TEST FAILED");
+        console.error(error.message);
         process.exit(1);
     }
 }
 
-// Timeout after 15 seconds if no response
-const timeout = setTimeout(() => {
-    console.log('\n--- Smoke Test Timeout (15s) ---');
-    cleanup();
-}, 15000);
-
-server.on('exit', (code, signal) => {
-    if (!isCleanedUp) {
-        console.log(`\n--- SGP Directory MCP exited unexpectedly (code: ${code}, signal: ${signal}) ---`);
-        cleanup();
-    }
-});
-
-server.on('error', (err) => {
-    console.error('\n❌ Failed to launch SGP Directory MCP:', err.message);
-    process.exit(1);
-});
+runSmokeTest();

package/server.json

@@ -3,7 +3,7 @@
   "name": "com.sgpdirectory/mcp",
   "description": "Singapore business directory. Search companies, UENs, and SSIC industry classifications.",
   "title": "Singapore Business Directory",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "websiteUrl": "https://sgpdirectory.com",
   "icons": [
     {
@@ -35,7 +35,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@sgpdirectory/mcp",
-      "version": "1.3.0",
+      "version": "1.3.1",
       "transport": {
         "type": "stdio"
       },

package/scripts/4-publish.sh

@@ -1,13 +0,0 @@
-#!/bin/bash
-
-# Ensure we're in the project root
-cd "$(dirname "$0")/.."
-
-# Publish to NPM
-echo "📦 Publishing to npmjs.com..."
-npm publish --access public
-
-# Publish to MCP Registry
-echo "🚀 Publishing to registry.modelcontextprotocol.io..."
-# mcp-publisher publish uses the server.json file to update the MCP registry
-mcp-publisher publish server.json