About Better MCP Client
Better MCP Client is an MCP server published by WLowe10 in the Developer Tools category: typescript MCP client implementation.
The repository has 1 stars and 0 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/WLowe10/better-mcp-clientThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Better MCP Client
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
better-mcp-client
This library is a TypeScript client implementation for the Model Context Protocol (MCP).
What makes this client the best?
- lightweight
- works in any runtime (browser, node, etc)
- separation of stateless and stateful client features
Why not use @modelcontextprotocol/sdk
As of 2025-08-12, there are multiple reasons to use better-mcp-client over @modelcontextprotocol/sdk
@modelcontextprotocol/sdkutilizes exports that may not work with module resolution@modelcontextprotocol/sdkdepends on node
Get started
Install
pnpm add better-mcp-client
# or
yarn add better-mcp-client
# or
npm install better-mcp-client
Examples
Over HTTP
import { Client } from "better-mcp-client";
import { HttpTransport, FetchAdapter } "better-mcp-client/http"
const transport = new HttpTransport({
adapter: new FetchAdapter(),
url: "http://localhost:8000/mcp",
});
const client = new Client({
info: {
name: "my-mcp-client",
version: "0.0.1",
},
transport,
});
// initialize client
const initializeResult = await client.initialize();
const sessionId = initializeResult.meta.sessionId;
// list tools
await client.listTools(
{},
{
sessionId,
}
);
Over stdio
import { Client } from "better-mcp-client";
import { StdioTransport } "better-mcp-client/stdio"
const transport = new StdioTransport({
command: "node",
args: ["./dist/main.js"]
});
const client = new Client({
info: {
name: "my-mcp-client",
version: "0.0.1",
},
transport,
});
// start the process
transport.start();
// initialize client
const initializeResult = await client.initialize();
// list tools
await client.listTools();
Session
Session is a wrapper around Client that automatically manages the mcp-session-id and requestId.
const transport = new HttpTransport({
adapter: new FetchAdapter(),
url: "http://localhost:8000/mcp",
});
const client = new Client({
info: {
name: "my-mcp-client",
version: "0.0.1",
},
transport,
});
const session = new Session({
client,
});
await session.initialize();
// no need to pass around the session id anymore :)
await client.listTools();
README fetched from the repository 7 days ago. The original is authoritative.