MCP (MODEL CONTEXT PROTOCOL) SERVERS

BUILT WITH NODE.JS & TYPESCRIPT, POWERED BY KV & MONGODB

      

DEVELOPED & DEPLOYED USING CURSOR • CLOUDFLARE • TESTED WITH CLAUDE AI

         

---

This repository is structured as a monorepo containing three standalone MCP (Model Context Protocol) server implementations mcp-basic, mcp-cloudflare, and mcp-mongo each built for different execution environments and use-cases, These servers can integrate with AI models (e.g., Claude AI) and can be tested using commands and prompts.

📑 Table of Contents

• 📌 Monorepo Overview
• 📁 Repository Structure
• 📁 Project Directory Layout
• 🚀 1) MCP Basic Server: Features & Installation
• 🌐 2) MCP Cloudflare Worker: Features & Installation
• 📦 3) MCP Mongo Server: Features & Installation
• 👤 Created By
• 📝 License

---

📌 Monorepo Overview

Project	Backend	Features	Use Cases
mcp-basic	Node.js, TypeScript, STDIO	Tools, Resources, Prompts	Local execution, CLI usage, MCP Inspector integration, Tested with Claude AI
mcp-cloudflare	Node.js, TypeScript, Cloudflare KV	Task/Todo CRUD tools, KV storage	Cloudflare Worker deployment, Remote execution via public endpoint, MCP Inspector, Tested with Claude AI
mcp-mongo	Node.js, TypeScript, MongoDB, STDIO	Task/Todo CRUD tools with persistence	Local execution, CLI usage, Persistent data handling, MCP Inspector, Tested with Claude AI

---

📁 Repository Structure

The repository is organized using the following structure:

model-context-protocol-server/
│── mcp-basic/         # Simple MCP server with Tools, Prompts, Resources
│── mcp-cloudflare/    # Cloudflare Worker MCP server with KV storage
│── mcp-mongo/         # MCP server with MongoDB persistent storage
│── LICENSE            # MIT License
└── README.md          # (You are reading this file)

---

📁 Project Directory Layout

The following directory structure is used in this monorepo:

model-context-protocol-server/
│
│── mcp-basic/                          # model-context-protocol-basic (Basic MCP server implementation)
│   ├── build/
│   ├── node_modules/
│   ├── src/
│   │   ├── prompts/
│   │   │   └── explainSql.ts
│   │   ├── resources/
│   │   │   └── productDetails.ts
│   │   ├── seed/
│   │   │   └── product.txt             # Example seed input file
│   │   ├── tools/
│   │   │   ├── addNumbers.ts
│   │   │   ├── divideNumbers.ts
│   │   │   ├── githubRepos.ts
│   │   │   ├── multiplyNumbers.ts
│   │   │   └── subtractNumbers.ts
│   │   └── index.ts
│   ├── .gitignore
│   ├── package.json                    # Project dependencies & scripts
│   └── tsconfig.json
│
│── mcp-cloudflare/                     # model-context-protocol-cloudflare (MCP implementation running on Cloudflare Workers)
│   ├── node_modules/
│   ├── src/
│   │   ├── models/
│   │   │   ├── schema.ts
│   │   │   ├── task.model.ts
│   │   │   └── todo.model.ts
│   │   ├── services/
│   │   │   ├── kv.service.ts
│   │   │   ├── task.service.ts
│   │   │   └── todo.service.ts
│   │   ├── tools/
│   │   │   ├── task.tools.ts
│   │   │   └── todo.tools.ts
│   │   ├── utils/
│   │   │   ├── error.ts
│   │   │   ├── id.ts
│   │   │   └── time.ts
│   │   └── index.ts
│   ├── test/
│   ├── .editorconfig
│   ├── .gitignore
│   ├── .prettierrc
│   ├── package.json                    # Project dependencies & scripts
│   ├── tsconfig.json
│   ├── vitest.config.mts
│   ├── worker-configuration.d.ts
│   └── wrangler.jsonc                  # Worker deployment configuration
│
│── mcp-mongo/                          # model-context-protocol-mongo (MCP server backed by MongoDB storage)
│   ├── build/
│   ├── node_modules/
│   ├── src/
│   │   ├── db/
│   │   │   └── mongo.ts
│   │   ├── models/
│   │   │   ├── schema.ts
│   │   │   ├── task.model.ts
│   │   │   └── todo.model.ts
│   │   ├── services/
│   │   │   ├── task.service.ts
│   │   │   └── todo.service.ts
│   │   ├── tools/
│   │   │   ├── task.tools.ts
│   │   │   └── todo.tools.ts
│   │   ├── utils/
│   │   │   ├── error.ts
│   │   │   └── time.ts
│   │   └── index.ts
│   ├── .gitignore
│   ├── package.json                    # Project dependencies & scripts
│   └── tsconfig.json
│
│── LICENSE                             # MIT License
└── README.md                           # Project Documentation

---

🚀 1) MCP Basic Server: Features & Installation

🔥 Features

The following features are included in the MCP Basic server:

1. 🔧 Tools Included

Name	Tool Function	Description
add-numbers	addNumbers	Returns the sum of two numeric values
subtract-numbers	subtractNumbers	Calculates the difference between two values
multiply-numbers	multiplyNumbers	Multiplies two numeric values
divide-numbers	divideNumbers	Divides one numeric value by another
get-github-repos	githubRepos	Retrieves public repos from a provided GitHub username

2. 📄 Resources Available

Name	Resource Handler	URI	File Source	Description
product-details	Product Details	products://all	/src/seed/product.txt	Provides product data (seed file)

3. 💡 Prompts Provided

Name	Prompt Description	Prompt Example
explain-sql-query	Generates a beginner-friendly explanation of any provided SQL query using the LLM.	Explain this SQL query in simple terms: ${sql} (be beginner-friendly).

---

⚙ Installation & Local Setup

Follow the steps below to run the MCP Basic server locally:

1. ✅ Clone the repository:

git clone https://github.com/PAIshanMadusha/model-context-protocol-server.git

2. ✅ Navigate to the Basic MCP server:

cd model-context-protocol-server/mcp-basic

3. ✅ Install dependencies:

npm install

4. ✅ Build the application:

npm run build

---

🧪 Run & Test

Below are multiple ways to test this MCP server using Inspector, Cursor, and Claude.

5. 🌐 Test using MCP Inspector (recommended):

npx @modelcontextprotocol/inspector

* After launching: Open the Inspector UI (auto-opens in browser), Click Add MCP Server & Use the following configuration:

Command: node Arguments: build/index.js

* Then click Connect to start testing tools.

6. 🌐 Test using Cursor IDE:

* Open Cursor: Settings → Tools → MCP and add:

"mcpServers": {
  "model-context-protocol-basic": {
    "command": "node",
    "args": ["C:/path/to/model-context-protocol-server/mcp-basic/build/index.js"] // replace with your actual path
  }
}

* Now you can use the tools directly inside Cursor's AI chats.

7. 🌐 Test with Claude AI (Desktop):

* Open Claude: **Settings → Developers → Edit config, Add:

"mcpServers": {
  "model-context-protocol-basic": {
    "command": "node",
    "args": ["C:/path/to/model-context-protocol-server/mcp-basic/build/index.js"] // replace with your actual path
  }
}

* Restart Claude & Start chatting and access the MCP Tools panel.

---

🌐 2) MCP Cloudflare Worker: Features & Installation

🔥 Features

This MCP server implementation runs entirely on Cloudflare Workers, offering task & todo management through HTTP-based MCP transport.

1. 🔧 Supported Tools: Task Management

Tool Name	Function	Description
create-task	Create Task	Creates a new task with title + details and stores it in KV backend.
list-tasks	List Tasks	Retrieves the full list of stored tasks with metadata and timestamps.
get-task-by-id	Retrieve Task	Fetches details of a specific task using its unique ID.
update-task-by-id	Update Task	Updates task fields such as name, status, or description.
delete-task-by-id	Delete Task	Permanently removes a task from storage using its ID.

2. 🔧 Supported Tools: Todo Management

Tool Name	Function	Description
create-todo	Add Todo	Creates a new todo item and associates it with a task (parent task required).
list-todos	List Todos	Retrieves all todo items under a specific task, grouped by task ID.
get-todo-by-id	Retrieve Todo	Fetches detailed information for a todo item using its ID.
update-todo-by-id	Update Todo	Updates todo fields such as text, checklist status, or completion progress.
delete-todo-by-id	Delete Todo	Deletes a specific todo item from its linked task.

3. 🗂 API Endpoints

* 🌍 Example Deployment: (Replace with your own deployment URL)

https://mcp-cloudflare.paishanmadusha.workers.dev

Route	Purpose
/mcp	REST-based MCP transport
/sse	Server-Sent-Events MCP streaming

⚠ Note: Cloudflare free-tier accounts do not allow creation of Worker KV storage, you can still test without storage using mcp-mongo (same tools, MongoDB backend).

---

⚙ Installation & Local Setup

Follow the steps below to run and deploy the Cloudflare MCP server:

1. ✅ Clone Repository:

git clone https://github.com/PAIshanMadusha/model-context-protocol-server.git

2. ✅ Navigate to Cloudflare MCP Server:

cd model-context-protocol-server/mcp-cloudflare

3. ✅ Install Dependencies:

npm install

4. ✅ Add Worker KV Binding:

* Create a KV namespace in Cloudflare → Storage & Database → Workers KV and enter it in wrangler.toml:

"kv_namespaces": [
		{
			"binding": "MCP_CLOUDFLARE_STORE",
			"id": "b98f377e26184191968cf4a2ad014df5", # replace with yours
			"remote": true
		}
	]

5. ✅ Deploy to Cloudflare:

wrangler deploy

---

🧪 Run & Test

Below are multiple ways to test this MCP server using Inspector, Cursor, and Claude.

6. 🌐 Test with MCP Inspector:

npx @modelcontextprotocol/inspector

* After launching: Open the Inspector UI (auto-opens in browser), Click Add MCP Server & Use the following configuration:

Command: node Arguments: https://mcp-cloudflare.paishanmadusha.workers.dev/mcp

* Then click Connect to start testing tools.

7. 🌐 Test using Cursor IDE:

* Open Cursor: Settings → Tools → MCP and add:

"mcpServers": {
  "model-context-protocol-cloudflare": {
    "command": "node",
    "args": ["https://mcp-cloudflare.paishanmadusha.workers.dev/mcp"]  // replace with your domain
  }
}

* Now you can use the tools directly inside Cursor's AI chats.

8. 🌐 Test with Claude Desktop (Recommended):

* Open Claude: **Settings → Developers → Edit config, Add:

"mcpServers": {
  "model-context-protocol-cloudflare": {
    "command": "node",
    "args": ["https://mcp-cloudflare.paishanmadusha.workers.dev/mcp"]   // replace with your domain
  }
}

* Restart Claude & Start chatting and access the MCP Tools panel.

---

📦 3) MCP Mongo Server: Features & Installation

🔥 Features

The following features are included in the MCP Mongo server:

1. 🔧 Supported Tools: Task Management

Tool Name	Function	Description
create-task	Create Task	Creates a new task with title + details and stores it in MongoDB backend.
list-tasks	List Tasks	Retrieves the full list of stored tasks with metadata and timestamps.
get-task-by-id	Retrieve Task	Fetches details of a specific task using its unique ID.
update-task-by-id	Update Task	Updates task fields such as name, status, or description.
delete-task-by-id	Delete Task	Permanently removes a task from storage using its ID.

2. 🔧 Supported Tools: Todo Management

Tool Name	Function	Description
create-todo	Add Todo	Creates a new todo item and associates it with a task (parent task required).
list-todos	List Todos	Retrieves all todo items under a specific task, grouped by task ID.
get-todo-by-id	Retrieve Todo	Fetches detailed information for a todo item using its ID.
update-todo-by-id	Update Todo	Updates todo fields such as text, checklist status, or completion progress.
delete-todo-by-id	Delete Todo	Deletes a specific todo item from its linked task.

---

⚙ Installation & Local Setup

Follow the steps below to run the MCP Mongo server locally:

1. ✅ Clone the repository:

git clone https://github.com/PAIshanMadusha/model-context-protocol-server.git

2. ✅ Navigate to the Mongo MCP server:

cd model-context-protocol-server/mcp-mongo

3. ✅ Install dependencies:

npm install

4. ✅ Build the application:

npm run build

---

🧪 Run & Test

Below are multiple ways to test this MCP server using Inspector, Cursor, and Claude.

5. 🌐 Test using MCP Inspector

npx @modelcontextprotocol/inspector

* After launching: Open the Inspector UI (auto-opens in browser), Click Add MCP Server & Use the following configuration:

Command: node Arguments: build/index.js

* Then click Connect to start testing tools.

6. 🌐 Test using Cursor IDE

* Open Cursor: Settings → Tools → MCP and add:

"mcpServers": {
  "model-context-protocol-mongo": {
    "command": "node",
    "args": ["C:/path/to/model-context-protocol-server/mcp-mongo/build/index.js"] // replace with your actual path
  }
}

* Now you can use the tools directly inside Cursor's AI chats.

7. 🌐 Test with Claude Desktop (recommended)

* Open Claude: **Settings → Developers → Edit config, Add:

"mcpServers": {
  "model-context-protocol-mongo": {
    "command": "node",
    "args": ["C:/path/to/model-context-protocol-server/mcp-mongo/build/index.js"] // replace with your actual path
  }
}

* Restart Claude & Start chatting and access the MCP Tools panel.

---

👤 Created By

Ishan Madhusha
GitHub: PAIshanMadusha

Feel free to explore my work and reach out if you'd like to collaborate! 🚀

---

📝 License

This project is licensed under the MIT License.
See the LICENSE file for more details.