Skip to main content
Glama
Sign In
MCP Server

MCP Server

by NavanethaKrishnan-14
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Example MCP Server

      Mtar786
      A
      license
      C
      quality
      Not graded
      maintenance
      A minimal Node.js Model Context Protocol server that exposes two simple tools ('add' and 'getTime') that can be called from AI assistants like Claude Desktop or Cursor.
      2
      118 npm
      MIT

    • bare-mcp

      CameronTofer
      A
      license
      Not graded
      quality
      D
      maintenance
      A minimal, general-purpose implementation of the Model Context Protocol (MCP) for Node.js and Bare runtime, enabling creation of AI-interactive servers with tools, resources, and multiple transport options.
      11 npm
      2
      MIT