# MCP Server 🚀

A lightweight and extensible **Model Context Protocol (MCP) Server** built with **Node.js** and the official MCP SDK. This project exposes custom tools and resources that can be used by MCP-compatible AI clients, enabling seamless integration with external services and AI models.

## ✨ Features

* 🔧 Custom MCP tools
* 🤖 AI model integration
* 📦 Modular project structure
* ⚡ Fast and lightweight
* 🔐 Environment variable support
* 🌐 JSON-RPC communication
* 📚 Easy to extend with new tools
* 📝 Resource support
* 🛠️ Developer-friendly architecture

---

## 🛠️ Tech Stack

* Node.js
* TypeScript
* Model Context Protocol (MCP) SDK
* Google Gemini API (Optional)
* dotenv

---

## 📂 Project Structure

```text
mcp-server/
├── src/
│   ├── index.ts
│   ├── tools/
│   ├── resources/
│   ├── handlers/
│   └── utils/
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
└── README.md
```

---

## 🚀 Installation

Clone the repository:

```bash
git clone https://github.com/NavanethaKrishnan-14/<repository-name>.git
```

Navigate to the project:

```bash
cd <repository-name>
```

Install dependencies:

```bash
npm install
```

---

## ⚙️ Environment Variables

Create a `.env` file in the project root.

Example:

```env
GEMINI_API_KEY=your_api_key
```

> **Never commit your actual `.env` file to GitHub.**

---

## ▶️ Running the Server

Development mode:

```bash
npm run dev
```

Production:

```bash
npm run build
npm start
```

---

## 🔧 Example MCP Tools

* Greeting Tool
* Calculator Tool
* AI Chat Tool (Gemini)
* Custom Resource Provider

These tools can be extended by adding new handlers in the `tools` directory.

---

## 📡 Compatible MCP Clients

This server can be integrated with MCP-compatible clients such as:

* Cursor
* Claude Desktop
* VS Code MCP extensions
* Custom MCP clients

---

## 📈 Future Enhancements

* Authentication support
* Streaming responses
* Database integration
* Logging and monitoring
* Additional AI providers
* File system tools
* Web search tools

---

## 🤝 Contributing

Contributions are welcome. Feel free to fork the repository, create a feature branch, and submit a pull request.

---

## 📄 License

This project is licensed under the MIT License.

---

## 👨‍💻 Author

**Navanetha Krishnan**

GitHub: https://github.com/NavanethaKrishnan-14