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

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

---

🚀 Installation

Clone the repository:

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

Navigate to the project:

cd <repository-name>

Install dependencies:

npm install

---

⚙️ Environment Variables

Create a .env file in the project root.

Example:

GEMINI_API_KEY=your_api_key

Never commit your actual .env file to GitHub.

---

▶️ Running the Server

Development mode:

npm run dev

Production:

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