MCP.so
Sign In

Demo MCP Basic

@bertrandgressier

Basic information

Category

Other

Transports

stdio

Author

bertrandgressier

About Demo MCP Basic

Demo of MCP server with HTTP SSE and a client

Demo MCP Basic config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Demo MCP Basic tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Demo MCP Basic?

Demo MCP Basic demonstrates a fundamental client‑server interaction using the Model Context Protocol (MCP). The server provides simple calculation tools (addition, subtraction, etc.) and the client, using the AI SDK, connects a Google AI model (Gemini/Vertex AI) to those tools, enabling the AI to call external functionalities during text generation.

How to use Demo MCP Basic?

Clone the repository, install dependencies (npm install), and create a .env file with your Google AI API key or Vertex AI project ID. Build the project with npm run build, then start the server (npm run start:server) and the client (npm run start:client). Development modes are available via npm run dev:server and npm run dev:client.

Key features of Demo MCP Basic

  • Offers basic arithmetic tools (addition, subtraction) via MCP.
  • Connects Google Gemini or Vertex AI models to external tools.
  • Client‑server architecture with SSE transport on localhost:3001.
  • Includes both production and development run scripts.
  • Fully typed TypeScript project with automatic compilation.

Use cases of Demo MCP Basic

  • Extending AI models with custom calculation tools.
  • Prototyping MCP‑based tool integrations for AI applications.
  • Learning how to implement an MCP client and server.
  • Demonstrating secure, local tool invocation from an AI model.

Frequently asked questions

1

What runtime dependencies does Demo MCP Basic require?

Node.js version 23.0 or higher and npm (bundled with Node.js). A Google AI API key (for Gemini) or a Vertex AI project ID is required.

2

How does the client communicate with the server?

The client connects to the server via SSE (Server‑Sent Events) at `http://localhost:3001/sse`.

3

What tools does the server provide?

The server exposes simple calculation tools, specifically addition and subtraction (and potentially other basic arithmetic operations).

4

Where does the application data live?

All configuration (API keys, project IDs) is stored locally in a `.env` file. No external databases are used; the server runs locally and communicates with Google’s AI services over HTTPS.

5

Are there any known limitations?

The server only offers basic arithmetic tools. The client is a demonstration script hard‑coded to evaluate `"6 + 12"` and relies on the AI model correctly invoking the tool. No authentication or secure transport beyond SSE is implemented.

Comments

More Other MCP servers