jayvadolkar/my-mcp-server-auth

📦 My MCP Server

My MCP Server is a no-ops, zero-server-maintenance API host that runs entirely on Cloudflare Workers. It wraps the Keka HRIS “getAllEmployees” endpoint (and more) behind a simple Model Context Protocol interface.

🚀 One-Click Deploy to Cloudflare Workers

Table of Contents

1. Overview
2. Prerequisites
3. Setup & Installation
4. Running Locally
5. Deploy to Production
6. Usage & Endpoints
7. .gitignore
8. Support

1. Overview

This project lets you host a fully-functional HRIS API server on Cloudflare in minutes—no servers to provision. It provides:

• Real-time SSE endpoint (/sse)
• Standard HTTP/MCP endpoint (/mcp)
• Tools like getAllEmployees, ping (others will come in future)

2. Prerequisites

• Cloudflare account: Sign up at dash.cloudflare.com
• Wrangler CLI: Install with npm install -g wrangler
• Node.js & npm: Version 18 or above (nodejs.org)
• Git: For cloning the repo (git-scm.com)

3. Setup & Installation

3.1 Clone the Repository

git clone https://github.com/jayvadolkar/my-mcp-server.git
cd my-mcp-server

3.2 Install Dependencies

npm install

3.3 Configure Environment Variables

Create a file named .dev.vars in the project root. This file keeps your secrets safe and is not checked into Git.

.COMPANY="your-company"  
.ENVIRONMENT="your-env"  
.KEKA_GRANT_TYPE="kekaapi"  
.KEKA_SCOPE="kekaapi"  
.KEKA_CLIENT_ID="PASTE_CLIENT_ID_HERE"  
.KEKA_CLIENT_SECRET="PASTE_CLIENT_SECRET_HERE"  
.KEKA_API_KEY="PASTE_API_KEY_HERE"

Wrangler will automatically load these when you run wrangler dev.

3.4 Build the Project

npm run build

4. Running Locally

Start a local preview of your Worker:

npm start

Open your browser at http://127.0.0.1:8787 You should see a JSON health check. To try the tools:

• ping:
  curl -X POST http://127.0.0.1:8787/mcp \ -d '{"tool":"ping","args":{"message":"hello"}}'
• checkEnv:
  curl -X POST http://127.0.0.1:8787/mcp \ -d '{"tool":"checkEnv","args":{}}'

5. Deploy to Production

Option A: One-Click Deploy
Click the button at the top of this README to deploy instantly. You’ll be prompted to select your Cloudflare account and to confirm your new Worker.

Option B: Wrangler CLI
If you prefer the terminal:

npx wrangler login
npm run build
npx wrangler publish

After publishing, your Worker will live at https://<your-subdomain>.workers.dev.

6. Usage & Endpoints

6.1 Health Check (GET /)

Returns JSON like:

{  
  "status":"running",
  "name":"CoreHR API MCP Server",
  "company":"your-company",
  "environment":"your-env",
  "endpoints":["/sse","/mcp"]  
}

6.2 SSE Endpoint (/sse)

Use a browser or SSE client to connect and receive live streams of tool results.

6.3 MCP HTTP (POST /mcp)

Example with getAllEmployees:

{  
  "tool":"getAllEmployees",  
  "args":{  
    "filters":{ "searchKey":"john" }  
  }  
}

8. Support & Feedback

Found an issue or need help? Open a GitHub Issue: https://github.com/jayvadolkar/my-mcp-server/issues

Happy deploying! 🚀