About Demo MCP Server Client Implementation
Demo MCP Server Client Implementation is an MCP server published by mschwarzmueller in the Developer Tools category: a demo implementation of a MCP server (consuming a dummy API) and basic client.
The repository has 29 stars and 8 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/mschwarzmueller/demo-mcp-server-client-implementationThis 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 Demo MCP Server Client Implementation
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 6 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !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.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
Example MCP Server + Client Implementation
I wrote an article and created a video about MCPs and why they're useful in my opinion.
This demo project contains a backend service / API that's consumed by a MCP server which exposes it in a standardized way to MCP clients - like the example MCP client (a very simple AI chatbot) that's also part of this project.
Important: All three parts (service, server, client) rely on Node.js being able to execute TypeScript without a compilation step. Yes, modern Node.js can do that! Make sure you have Node.js 23.x or higher installed!
Configuration
Add a .env file inside the client folder (next to the package.json file there) and add the following content to it:
OPENAI_API_KEY=<your-open-ai-key>
In each folder (service, server, client) run npm install to install required dependencies.
Running Service, MCP Server & MCP Client
For each part, navigate into the respective folder (service, server and client) and run npm run dev (with Node.js 23+). Keep each process running.
The "client" process is a simply AI chatbot using OpenAI behind the scenes. This chatbot has the custom MCP server "installed" - therefore, this AI chat application is able to store and retrieve custom information via the backend service created in the "service" folder.
Bugs are possible - it's just a basic demo implementation :-)
README fetched from the repository 6 days ago. The original is authoritative.