TM

theailanguage/mcp_client

Developer tools
115ย stars 0 forks Quality 60 Trend 60

๐Ÿ“ข Subscribe to The AI Language on YouTube!

Overview

๐Ÿ“ข Subscribe to The AI Language on YouTube!

README

๐Ÿš€ MCP Client with Gemini AI

๐Ÿ“ข Subscribe to The AI Language on YouTube!

Welcome! This project features multiple MCP clients integrated with Google Gemini AI to execute tasks via the Model Context Protocol (MCP) โ€” with and without LangChain.

Happy building, and donโ€™t forget to subscribe!

MCP Client Options

This repository includes four MCP client options for various use cases:

Option Client Script LangChain Config Support Transport Tutorial
1 client.py โŒ โŒ STDIO Legacy Client
2 langchain_mcp_client.py โœ… โŒ STDIO LangChain Client
3 langchain_mcp_client_wconfig.py โœ… โœ… STDIO Multi-Server
4 client_sse.py โŒ โŒ SSE (Loca & Web) SSE Client

If you want to add or reuse MCP Servers, check out the MCP Servers repo.


โœช Features

โœ… Connects to an MCP server (STDIO or SSE)
โœ… Uses Google Gemini AI to interpret user prompts
โœ… Allows Gemini to call MCP tools via server
โœ… Executes tool commands and returns results
โœ… (Upcoming) Maintains context and history for conversations


Running the MCP Client

Choose the appropriate command for your preferred client:

  • Legacy STDIO โ€” uv run client.py path/to/server.py
  • LangChain STDIO โ€” uv run langchain_mcp_client.py path/to/server.py
  • LangChain Multi-Server STDIO โ€” uv run langchain_mcp_client_wconfig.py path/to/config.json
  • SSE Client โ€” uv run client_sse.py sse_server_url

Project Structure

mcp-client-gemini/
โ”œโ”€โ”€ client.py                        # Basic client (STDIO)
โ”œโ”€โ”€ langchain_mcp_client.py         # LangChain + Gemini
โ”œโ”€โ”€ langchain_mcp_client_wconfig.py # LangChain + config.json (multi-server)
โ”œโ”€โ”€ client_sse.py                   # SSE transport client (local or remote)
โ”œโ”€โ”€ .env                            # API key environment file
โ”œโ”€โ”€ README.md                       # Project documentation
โ”œโ”€โ”€ requirements.txt                # Dependency list
โ”œโ”€โ”€ .gitignore                      # Git ignore rules
โ”œโ”€โ”€ LICENSE                         # License information

How It Works

  1. You send a prompt:

    Create a file named test.txt

  2. The prompt is sent to Google Gemini AI.
  3. Gemini uses available MCP tools to determine a response.
  4. The selected tool is executed on the connected server.
  5. The AI returns results and maintains conversation context (if supported).

๐Ÿค Contributing

At this time, this project does not accept external code contributions.

This is to keep licensing simple and avoid any shared copyright.

Youโ€™re very welcome to: โœ… Report bugs or request features (via GitHub Issues)
โœ… Fork the repo and build your own version
โœ… Suggest documentation improvements

If youโ€™d like to collaborate in another way, feel free to open a discussion!

View this README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide