# MCP Client Server Project Using NodeJS

> A minimal Model Context Protocol (MCP) implementation built with Node.js and TypeScript. This project demonstrates client–server communication over stdio, structured message handling, and local data access, developed with VS Code and GitHub Copilot to explore modern AI tool integration workflows.

- **Type:** MCP server
- **Install:** `agentstack add mcp-dyneth02-mcp-client-server-project-using-nodejs`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [dyneth02](https://agentstack.voostack.com/s/dyneth02)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [dyneth02](https://github.com/dyneth02)
- **Source:** https://github.com/dyneth02/MCP-Client-Server-Project-using-NodeJS

## Install

```sh
agentstack add mcp-dyneth02-mcp-client-server-project-using-nodejs
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Simple MCP with Node.js & TypeScript

This project is a minimal, educational implementation of a **Model Context Protocol (MCP)**–style system using **Node.js** and **TypeScript**. It demonstrates how a client and server can communicate over standard input/output (stdio) using structured messages, simulating how modern AI tools interact with external context providers.

The project was built using **VS Code** with **GitHub Copilot**, exploring how AI-assisted development integrates with protocol-based system design.

---

## 🚀 What This Project Demonstrates

- A lightweight MCP-style **client–server architecture**
- Communication over **stdio** instead of HTTP
- Structured request/response handling
- Type-safe development with TypeScript
- Local JSON-based data access
- Practical experimentation with AI tooling workflows

This repository focuses on **clarity over complexity**, making it ideal for learning, experimentation, and extension.

---

## 🧠 Architecture Overview
      Client (client.ts)
      |
      | stdio messages
      v
      Server (server.ts)
      |
      | Reads local data
      v
      users.json
  
- **Client** sends structured requests
- **Server** processes requests and responds via stdio
- **users.json** acts as a mock data source
- **mcp.json** defines how the MCP server is launched and integrated

---

## 📁 Project Structure

      ├── client.ts # MCP client implementation
      ├── server.ts # MCP server implementation
      ├── users.json # Sample data source
      ├── mcp.json # MCP server configuration
      ├── package.json
      ├── package-lock.json
      └── README.md

---

## ⚙️ How It Works

1. The MCP server is launched using Node.js (configured in `mcp.json`)
2. The client communicates with the server via stdio
3. Requests are parsed and handled in a structured manner
4. The server reads from `users.json` and returns results
5. Responses are sent back to the client in a predictable format

This mirrors how AI tools query external systems for context without relying on traditional REST APIs.

---

## ▶️ Running the Project

### Install dependencies
```bash
npm install
npm run build
node build/server.js
(Client execution depends on your MCP setup or test harness.)
```
---

🧪 Why This Matters

Modern AI systems increasingly rely on protocol-driven context sharing rather than monolithic APIs. This project provides a hands-on foundation for understanding:

- AI tool integrations
- Context-aware systems
- Protocol-oriented backend design
- Developer tooling workflows

---

📌 Notes

- This is a learning and exploration project
- Designed to be easily extended (databases, auth, tools, schemas)
- Emphasizes readability and correctness over feature depth

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [dyneth02](https://github.com/dyneth02)
- **Source:** [dyneth02/MCP-Client-Server-Project-using-NodeJS](https://github.com/dyneth02/MCP-Client-Server-Project-using-NodeJS)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-dyneth02-mcp-client-server-project-using-nodejs
- Seller: https://agentstack.voostack.com/s/dyneth02
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.