mcsm-mcp

English | 中文

Overview

mcsm-mcp is a lightweight MCP (Model Context Protocol) client library that enables your applications to communicate with MCPcompatible 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.

Project Links

• GitHub Repository: https://github.com/SMGoro/mcsm-mcp
• MCSManager Site: https://mcsmanager.com/
• Model Context Protocol: https://modelcontextprotocol.io/

License

AGPL-3.0