@sgpdirectory/mcp

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

npx -y @sgpdirectory/mcp

Usage with Claude Desktop

Add this to your mcp-servers.json configuration file:

{
  "mcpServers": {
    "sgpdirectory": {
      "command": "npx",
      "args": ["-y", "@sgpdirectory/mcp"]
    }
  }
}

Authentication

If your proxy is behind an access token, you can pass it via SGP_API_TOKEN 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

{
  "mcpServers": {
    "sgpdirectory": {
      "command": "npx",
      "args": ["-y", "@sgpdirectory/mcp"],
      "env": {
        "API_TOKEN": "your-secret-token"
      }
    }
  }
}

Publishing to NPM

• Login to NPM Run the login command and follow the prompts. You need to be a part of the @sgpdirectory org.

  npm login
  

  (Note: if you don't own @sgpdirectory, change the name in package.json to something like sgpdirectory-mcp-wrapper without the @ scope)

• Publish the package Run the following inside your wrapper directory:

  npm publish --access public
  

  Your local package changes are now pushed online and can be used immediately by clients via npx!

Local Testing

If you have cloned the repository locally, you can run:

npm install
npm start

This will launch the proxy and wait for standard stdio JSON-RPC messages.