Connects to MCP servers using Streamable HTTP or stdio with support for bearer authentication and custom headers.
Also known as eliware/mcp-client, @eliware/mcp-client
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 1,464
- Latest version
- —
- Last commit
- Oct 27, 2026
- License
- MIT
What is MCP Client MCP?
MCP Client connects to MCP servers using Streamable HTTP or stdio with support for bearer authentication and custom headers.
Summary generated from the project's README
About MCP Client MCP server
Connecting to Model Context Protocol servers through various transport layers is the primary function of this client. It allows developers to establish connections using either stdio or Streamable HTTP. This tool is designed for Node.js environments running version 26 or later and is built as a pure ESM package for SDK v2.
Users can manage secure connections by implementing bearer authentication, custom HTTP headers, or specific token providers. The client provides structured logs to help monitor interactions and includes a listTools method to discover available capabilities on a connected server. It is intended for developers building applications that need to interact with remote or local MCP servers via npm installation.
What you can do with it
- 1Discover available server toolsAsk the client to retrieve a list of all tools provided by a connected MCP server.
- 2Establish secure HTTP connectionsConnect to a remote MCP server using a specific URL and authentication headers.
- 3Integrate MCP into Node.js appsAdd MCP client capabilities to a JavaScript project using npm.
Written from the project's README. Every use case is checked against a quote from it.
How to install MCP Client MCP
Formats verified 10 Nov 2026Add to CursorInstall MCP Client MCP in Claude Code
$ claude mcp add mcp-client -- npx -y @eliware/mcp-clientInstall MCP Client MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-client": {
"command": "npx",
"args": [
"-y",
"@eliware/mcp-client"
]
}
}
}Install MCP Client MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-client": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@eliware/mcp-client"
]
}
}
}Install MCP Client MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-client","type":"stdio","command":"npx","args":["-y","@eliware/mcp-client"]}'Install MCP Client MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-client": {
"command": "npx",
"args": [
"-y",
"@eliware/mcp-client"
]
}
}
}Install MCP Client MCP in Codex
~/.codex/config.toml
[mcp_servers.mcp-client] command = "npx" args = ["-y", "@eliware/mcp-client"]
Install MCP Client MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"mcp-client": {
"command": "npx",
"args": [
"-y",
"@eliware/mcp-client"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableeliware/mcp-client is public and reachablegithub.com/eliware/mcp-client ↗Pass
- Package names this repository as its source@eliware/mcp-client names eliware/mcp-client as sourcenpmjs.com/package/@eliware/mcp-client ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @eliware/mcp-clientnpmjs.com/package/@eliware/mcp-client/v/15.0.1#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-27github.com/eliware/mcp-client ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @eliware/mcp-clientPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub
@eliware/mcp-client 
Pure ESM MCP client for SDK v2, Streamable HTTP, stdio, and bearer authentication.
Table of Contents
- Features
- Requirements
- Setup
- Usage
- Development
- Testing
- Troubleshooting
- Security
- API
- Packaging
- Examples
- Support
- Links
- License
Features
Connect to MCP servers through Streamable HTTP or stdio. Use bearer tokens, custom HTTP headers, token providers, and structured logs.
Requirements
Use Node.js 26 or later.
Setup
Install the package with npm install @eliware/mcp-client.
Usage
import { mcpClient } from "@eliware/mcp-client";
const client = await mcpClient({ url: "https://mcp.example.com/mcp" });
try {
console.log(await client.listTools());
} finally {
await client.close();
}
Read the documentation index, specifications, and release notes.
Development
Run npm ci to install locked dependencies. Read repository specifications for contributor requirements.
Testing
Run npm test for aggregate validation.
Troubleshooting
Read the troubleshooting guide for connection help.
Security
Keep access tokens, credentials, and private server data out of source files and logs.
API
Import mcpClient from @eliware/mcp-client. Read the API guide for options and return types.
Packaging
The package includes src/, docs/, README.md, AGENTS.md, LICENSE, RELEASE_NOTES.md, examples/, specs/, and .env.example.
Use numeric MAJOR.MINOR.PATCH versions and a v<version> tag for each release.
Run npm run pack to check package contents. Publish only after approved release steps.
Examples
Read the examples index for commands, results, permissions, and cleanup.
Support
For help, questions, or to chat with the author and community, visit:
Links
License
MCP Client MCP questions
How do I add MCP Client MCP to Claude Code?
Run claude mcp add mcp-client -- npx -y @eliware/mcp-client in your terminal. Add --scope user to make it available in every project.
How do I add MCP Client MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What are the system requirements for this client?
You must use Node.js version 26 or later.
How can I connect to MCP servers?
The client supports connections through Streamable HTTP or stdio.
How do I install the package?
You can install it using the command npm install @eliware/mcp-client.