@sgpdirectory/mcp 1.0.1

package/README.md

@@ -0,0 +1,70 @@
+# @sgpdirectory/mcp
+
+Official local MCP (Model Context Protocol) wrapper for the `sgpdirectory` remote server.
+
+This package provides a standard `stdio` interface compatible with local MCP clients (like Claude Desktop and Cursor), proxying requests securely to the remote HTTP streamable sgpdirectory server (`https://mcp.sgpdirectory.com/mcp`).
+
+## Usage with Cursor
+Run the following package directly using `npx`:
+
+When configuring Cursor, set the MCP "Type" to `command` and use:
+```bash
+npx -y @sgpdirectory/mcp
+```
+
+## Usage with Claude Desktop
+Add this to your `mcp-servers.json` configuration file:
+
+```json
+{
+  "mcpServers": {
+    "sgpdirectory": {
+      "command": "npx",
+      "args": ["-y", "@sgpdirectory/mcp"]
+    }
+  }
+}
+```
+
+## Authentication
+
+If your proxy is behind an access token, you can pass it via `SGP_DIRECTORY_API_KEY` environment variable. The wrapper will automatically format it as an `Authorization: Bearer <TOKEN>` header and attach it to the `mcp-remote` connection.
+
+### Example in Claude Desktop
+```json
+{
+  "mcpServers": {
+    "sgpdirectory": {
+      "command": "npx",
+      "args": ["-y", "@sgpdirectory/mcp"],
+      "env": {
+        "SGP_DIRECTORY_API_KEY": "your-secret-token"
+      }
+    }
+  }
+}
+```
+
+## Publishing to NPM
+
+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
+   ```
+
+2. **Publish the package**
+   Run the following inside your wrapper directory:
+   ```bash
+   npm publish --access public
+   ```
+
+## Local Testing
+If you have cloned the repository locally, you can run:
+
+```bash
+npm install
+npm start
+```
+
+This will launch the proxy and wait for standard `stdio` JSON-RPC messages.

package/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+/**
+ * @sgpdirectory/mcp
+ * A simple stdio proxy for the sgpdirectory remote Model Context Protocol (MCP) server.
+ * This executable connects to the remote HTTP streamable server.
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+const REMOTE_URL = 'https://mcp.sgpdirectory.com/mcp';
+
+// Find the local mcp-remote executable within our own node_modules
+// This ensures we run the pinned version we depend on.
+const mcpRemoteBin = require.resolve('mcp-remote/dist/proxy.js'); // Standard resolution or fallback to npx
+
+function startProxy() {
+    const args = ['mcp-remote', REMOTE_URL];
+
+    // If the user provided an API token via SGP_DIRECTORY_API_KEY environment variable,
+    // append it as an Authorization header to the mcp-remote call.
+    const token = process.env.SGP_DIRECTORY_API_KEY;
+    if (token) {
+        args.push('--header', `Authorization: Bearer ${token}`);
+    }
+
+    // We use npx mcp-remote because mcp-remote exposes its proxy utility.
+    // Instead of importing, we spawn the CLI directly to inherit its exact stdio behavior.
+    const child = spawn('npx', args, {
+        stdio: 'inherit',
+        env: {
+            ...process.env,
+            // Pass any required env vars from the local client if necessary
+        }
+    });
+
+    child.on('error', (err) => {
+        console.error(`[sgpdirectory-mcp] Failed to start underlying proxy: ${err.message}`);
+        process.exit(1);
+    });
+
+    child.on('exit', (code, signal) => {
+        if (code !== null) {
+            process.exit(code);
+        } else {
+            process.exit(1);
+        }
+    });
+}
+
+if (require.main === module) {
+    startProxy();
+}
+
+module.exports = { startProxy };

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@sgpdirectory/mcp",
+  "version": "1.0.1",
+  "description": "The official local MCP stdio package for sgpdirectory remote server",
+  "main": "index.js",
+  "scripts": {
+    "start": "node ./index.js",
+    "test": "node scripts/smoke-test.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "mcp-remote": "^0.1.38"
+  },
+  "bin": {
+    "sgpdirectory-mcp": "./index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/smoke-test.js

@@ -0,0 +1,93 @@
+#!/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.
+ */
+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'
+    }
+});
+
+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();
+    }
+});
+
+server.stderr.on('data', (data) => {
+    console.error('[STDERR]:', data.toString().trim());
+});
+
+const initializeRequest = JSON.stringify({
+    jsonrpc: '2.0',
+    id: 1,
+    method: 'initialize',
+    params: {
+        protocolVersion: '2024-11-05',
+        capabilities: {},
+        clientInfo: { name: 'smoke-test', version: '1.0.0' }
+    }
+}) + '\n';
+
+console.log('Sending initialize request to local proxy...');
+server.stdin.write(initializeRequest);
+
+let isCleanedUp = false;
+function cleanup() {
+    if (isCleanedUp) return;
+    isCleanedUp = true;
+
+    clearTimeout(timeout);
+    server.kill();
+
+    if (responseFound) {
+        console.log('\n✅ SMOKE TEST PASSED: SGP Directory MCP proxy responded to initialize request.');
+        process.exit(0);
+    } else {
+        console.error('\n❌ SMOKE TEST FAILED: SGP Directory MCP proxy did not respond with a valid JSON-RPC result.');
+        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);
+});

package/server.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
+  "name": "io.github.sgpdirectory/sgpdirectory-mcp",
+  "description": "Official local MCP wrapper for sgpdirectory remote server",
+  "status": "active",
+  "repository": {
+    "url": "https://github.com/sgpdirectory/sgpdirectory-mcp-package",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp.sgpdirectory.com/mcp",
+      "environment_variables": [
+        {
+          "name": "SGP_DIRECTORY_API_KEY",
+          "description": "Your API key for the service",
+          "is_required": false,
+          "format": "string",
+          "is_secret": true
+        }
+      ]
+    }
+  ],
+  "packages": [
+    {
+      "registry_type": "npm",
+      "registry_base_url": "https://registry.npmjs.org",
+      "identifier": "@sgpdirectory/mcp",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environment_variables": [
+        {
+          "name": "SGP_DIRECTORY_API_KEY",
+          "description": "Your API key for the service",
+          "is_required": false,
+          "format": "string",
+          "is_secret": true
+        }
+      ]
+    }
+  ]
+}