lqwangxg/mcp-server-hello

MCP Server Hello

This project implements a Model Context Protocol (MCP) server that provides several tools, resources, and prompts. It's designed to be used with the Gemini CLI as an MCP server.

Available Functionalities

• add tool: Adds two numbers together.
• get-time tool: Returns the current server time.
• update-config-index tool: update the index in configfile by increment.
• random-joke resource: Provides a random joke.
• friendly-greeting prompt: Generates a friendly greeting message given a name.

Installation

To set up the project, follow these steps:

1. Clone the repository (if applicable):

   # If this project is part of a larger repository, clone it first.
   # git clone <repository-url>
   # cd mcp-server-hello
   

2. Install dependencies: Navigate to the project root directory and install the required Node.js packages:

   npm install
   

How to Run

To run the MCP server:

1. Build the TypeScript project:

   npm run build
   

2. Start the server:

   npm start
   

   The server will start and listen for connections. You won't see much output on the console as console.log has been removed to avoid interfering with the MCP protocol. Errors will be logged to stderr.

Deployment

This server is intended to be run as a background process, typically managed by a process manager or as part of a larger system. Ensure that the npm run build step is executed before starting the server in a production environment.

Usage with Gemini CLI

1. create ./.gemini/settings.json for Gemini CLI

   {
   "mcpServers": {
       "my-mcp": {
       "command": "node",
       "args": ["./dist/server.js"],
       "transport": "stdio"
       }
   }
   }
   

2. check mcp server status by /mcp list after gemini-cli start

   • This server acts as an MCP server for the Gemini CLI.
   • Once the server is running, the Gemini CLI can connect to it and utilize the registered tools, resources, and prompts.

    ℹConfigured MCP servers:
    
    🟢 my-mcp - Ready (2 tools, 1 prompt)
        Tools:
        - add
        - get-time
   
        Prompts:
        - friendly-greeting
   
   
    💡 Tips:
        • Use /mcp desc to show server and tool descriptions
        • Use /mcp schema to show tool parameter schemas
        • Use /mcp nodesc to hide descriptions
        • Use /mcp auth <server-name> to authenticate with OAuth-enabled servers
        • Press Ctrl+T to toggle tool descriptions on/off   
   

Test of tools, resources, and prompts by Gemini-cli

The Gemini CLI will communicate with this MCP server to execute the requested functionality and return the results.

1. invoke the 'add' tool

   #prompt1: 
   > result of add 123456,456789 
    ✓  add (summarize-mcp MCP Server) {"b":456789,"a":123456}        
    The sum of 123456 and 456789 is 580245.   
   #result of add 123456,456789 
   ✦ 580245
   
   #prompt2: 
   > add 123,456 
    ✓  add (summarize-mcp MCP Server) {"b":456,"a":123}       
    The sum of 123 and 456 is 579.   
   ✦ 579
   

2. invoke the 'get-time' tool

   #prompt: 
   >  what time now? 
    ✓  get-time (summarize-mcp MCP Server) {}       
    The current server time is 14:28:32. 
   ✦ The current time is 14:28:32. 
   

3. invoke the 'random-joke' resource

   #prompt: 
   >  tell me a joke 
   ✦ Why don't scientists trust atoms?    
   Because they make up everything 
   

4. invoke the 'friendly-greeting' prompt

   #prompt
   > friendly-greeting to wangxg 
   ✦ Hello, wangxg! It's a pleasure to meet you. I hope you're having a fantastic day
   

5. invoke the 'update-config-index' tool

   #prompt:
   > update the index in configfile @config/config.yaml by increment 10
   ✓  update-config-index (my-mcp) {"numberOfIncrements":10,"filePath":"C:\\work\\mcp-server\\mcp-server-hello\\config\\config.yaml"}
   OK. I've updated the index in `config/config.yaml` to 12.