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

Related MCP server: Example MCP Server

🛠️ 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