home / mcp / custom mcp server

Custom MCP Server

Provides a modular MCP server with tools and Google ADK integration for actions, analytics, and fulfillment placeholders.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "aakankshagupta18-custom-mcp-server": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "GOOGLE_ADK_ENABLED": "true"
      }
    }
  }
}

You can run a Model Context Protocol (MCP) server that exposes a set of tools and integrates with Google ADK to handle fulfillment and analytics. This server-oriented setup lets you build modular tools, test interactions with an MCP client, and extend capabilities over time while keeping a clean, type-safe architecture.

How to use

Use an MCP client to talk to the server and invoke the available tools. You can perform calculations, inspect system information, and read or write files through the defined tools. If you enable the Google ADK integration, you gain analytics logging for tool usage and placeholder fulfillment handling for Google Assistant requests.

How to install

Prerequisites: you need Node.js 18+ and npm or yarn installed on your system.

Install dependencies, build, and run the server in development mode, then run the built server when ready.

npm install
npm run build
npm run dev
npm start

Claude Desktop configuration example

If you want to test with Claude Desktop, you can add the MCP server configuration to Claude Desktop settings as shown in the example below.

{
  "mcpServers": {
    "demo": {
      "command": "node",
      "args": ["/path/to/mcp-server-demo/dist/index.js"]
    }
  }
}

Available tools

calculator

Performs basic mathematical operations such as add, subtract, multiply, and divide using a typed calculator tool.

file_operations

Reads, writes, lists, and provides information about files with validated input to prevent directory traversal risks.

system_info

Retrieves system-level information such as platform, memory, and CPU details for observability.