1. Conduid
  2. AI
  3. Client Demo
MCP server · AI

Client Demo

by · github.com/yonaka15/mcp-client-demo

A demo implementation of a Model Context Protocol (MCP) client using Web Workers and Server-Sent Events (SSE).

Unclaimed last commit a year ago ai
InstallView source
34Low

Scored 5 days ago · breakdown

About Client Demo

Client Demo is an MCP server published by yonaka15 in the AI category: a demo implementation of a Model Context Protocol (MCP) client using Web Workers and Server-Sent Events (SSE).

The repository has 8 stars and 3 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

From source
git clone https://github.com/yonaka15/mcp-client-demo

This 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 Client Demo

Powered by Claude · Grounded in docs

I know everything about Client Demo. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository yesterday. 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 presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.

1 check has not been run yet.

README

MCP Client Demo

Note: This project is currently a work in progress (WIP). Features and implementations may change significantly.

A demo implementation of a Model Context Protocol (MCP) client using Web Workers and Server-Sent Events (SSE).

Features

  • Web Worker-based MCP client implementation
  • Server-Sent Events (SSE) transport
  • Interactive testing UI
  • Type-safe implementation with TypeScript
  • Built with Vite + React

Getting Started

Prerequisites

  • Node.js 18.x or later
  • An MCP-compatible server running on localhost:3020

Installation

  1. Clone the repository
  2. Install dependencies:
npm install

Development

Start the development server:

npm run dev

Testing the Worker

  1. Open test.html in your browser
  2. Click "Connect" to establish connection with the MCP server
  3. Use "List Tools" to see available tools
  4. Select a tool and provide input in JSON format
  5. Click "Execute Tool" to run the selected tool

Project Structure

src/
├── worker.ts           # MCP client worker implementation
├── worker-test.ts      # Worker test interface
├── types.ts           # Type definitions
└── App.tsx           # Main React application

Key Components

  • worker.ts: Main Web Worker implementation of the MCP client
  • worker-test.ts: Testing interface for the worker
  • types.ts: Shared type definitions for worker commands and responses

Implementation Details

Worker Commands

The worker accepts the following commands:

  • connect: Establish connection with MCP server
  • disconnect: Close the connection
  • listTools: Get list of available tools
  • callTool: Execute a specific tool

Worker Responses

The worker sends responses in the following format:

type WorkerResponse =
  | {
      type: "status";
      status: WorkerStatus;
    }
  | {
      type: "result";
      result: ListToolsResult | CallToolResult;
    }
  | {
      type: "error";
      error: string;
      details?: Record<string, unknown>;
    };

Development

Building

Build the project:

npm run build

Linting

Run ESLint:

npm run lint

Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a new Pull Request

README fetched from the repository yesterday. The original is authoritative.

Questions

About Client Demo

How do I install Client Demo?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Client Demo safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 3 of the 5 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Client Demo still maintained?

The last commit was a year ago and 1 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.