Skip to main content
Glama
SMGoro
by SMGoro

mcsm-mcp

English | 中文

Overview

mcsm-mcp is a lightweight MCP (Model Context Protocol) client library that enables your applications to communicate with MCP‑compatible servers. It supports multiple transport mechanisms – STDIO, SSE, and Streamable HTTP – and can be used from both CLI scripts and UI tools.


Installation

git clone https://github.com/SMGoro/mcsm-mcp.git cd mcsm-mcp npm install npm run build

The package works on Windows, macOS and Linux.


Configuration & Usage

The client reads its configuration from a JSON file (default name mcp.json). Below are examples for the three supported transports.

STDIO (default)

{ "mcpServers": { "my-stdio-server": { "type": "stdio", "command": "node", "args": ["build/index.js", "--debug"], "env": { "MCSM_API_KEY": "your-api-key", "MCSM_API_URL": "http://localhost:23333", "DEBUG": "true" } } } }

Streamable HTTP

{ "mcpServers": { "my-http-server": { "type": "streamable-http", "url": "http://localhost:3010/mcp?mcsm-api-key=your-api-key&mcsm-api-url=http://localhost:23333" } } }

Save the file as mcp.json in your project root or specify a custom path with the --config flag.


Testing the Client

CLI Mode (scriptable)

The library ships with a CLI wrapper that can be invoked via npx @modelcontextprotocol/inspector.

# Basic usage – start a server and open the UI npx @modelcontextprotocol/inspector node build/index.js # CLI mode – run a single command without UI npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list # Using a custom config file npx @modelcontextprotocol/inspector --cli --config ./mcp.json --server my-stdio-server

UI Mode (interactive)

Running the command without --cli starts the MCP Inspector UI on http://localhost:6274.

npx @modelcontextprotocol/inspector node build/index.js

You can also launch the UI directly from an existing configuration:

npx @modelcontextprotocol/inspector --config ./mcp.json

The project includes a comprehensive test suite that validates each transport (STDIO, SSE, Streamable HTTP). Tests are based on the MCP Inspector documentation in docs/MCPInspector_README.md.

  1. Open the Inspector UI (see UI Mode above).

  2. In the Servers File panel click "Servers File" to copy a full configuration for the transport you want to test.

  3. Save the JSON to a temporary file, e.g. mcp-test.json.

  4. Run the CLI test command:

    npx @modelcontextprotocol/inspector --cli --config ./mcp-test.json --method tools/list
  5. Verify the output matches the expected tool list for your server.

Both GUI and CLI modes are exercised automatically by the CI pipeline.


License

AGPL-3.0

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SMGoro/mcsm-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server