mcp-client-server-python

sofianhw/mcp-client-server-python

3.1
developer_toolsai_chatbot

If you are the rightful owner of mcp-client-server-python and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This project demonstrates a simple client-server Model Context Protocol (MCP) implementation using Python.

MCP Client-Server Python Example

This project demonstrates a simple client-server MCP.

What is MCP (Model Context Protocol)?

MCP is an open protocol introduced by Anthropic to enable large language models (LLMs) to interact with external tools, APIs, and resources in a standardized, extensible way.
It facilitates secure, multi-channel communication between AI models and external systems, supporting advanced agentic workflows and tool use.

šŸ”— Anthropic's announcement
šŸ”— MCP documentation

Features

  • MCP Server: Exposes tools (e.g., addition) and resources (e.g., greetings) via SSE.
  • MCP Client: Connects to the server, lists available tools, and interacts using OpenAI's chat completions.
  • OpenAI Integration: Uses OpenAI's GPT models to process user queries and call server tools as needed.

Requirements

Project Structure

.
ā”œā”€ā”€ client.py      # MCP client implementation
ā”œā”€ā”€ server.py      # MCP server implementation
ā”œā”€ā”€ pyproject.toml # Project metadata and dependencies
ā”œā”€ā”€ .env           # Environment variables (not committed)
ā””ā”€ā”€ README.md      # This file

Install dependencies with uv:

uv sync

(This will install all dependencies as specified in uv.lock.)

Setup

  1. Environment Variables

    Create a .env file in the project directory:

    OPENAI_API_KEY=your-openai-api-key
MCP_SSE_URL=http://localhost:8080/sse

  2. Start the Server

    uv run server.py --host 0.0.0.0 --port 8080

    The server exposes tools and resources via SSE at /sse.

  3. Run the Client

    In another terminal:

    uv run client.py

    The client will connect to the server, list available tools, and start an interactive chat loop.

Usage

  • Type your queries in the client prompt.
  • The client will use OpenAI to process your query and call server tools if needed.
  • Type quit to exit the client.

Related MCP Servers

View all developer_tools servers ā†’
claude-task-master

claude-task-master

4.7

by eyaltoledano

Task Master is a task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.

ai_chatbot
paelladoc

paelladoc

4.5

by jlcases

PAELLADOC is an AI-First Development framework implementing the Model Context Protocol (MCP) to enhance LLM interactions with external tools and context.

ai_chatbot
mcpdoc

mcpdoc

4.5

by langchain-ai

MCP LLMS-TXT Documentation Server provides a structured way to manage and retrieve LLM documentation using the Model Context Protocol.

developer_tools
exa-mcp-server

exa-mcp-server

4.5

by exa-labs

A Model Context Protocol (MCP) server allows AI assistants to use the Exa AI Search API for real-time web searches in a secure manner.

research_and_data
n8n-workflow-builder

n8n-workflow-builder

4.5

by makafeli

The n8n Workflow Builder MCP Server is designed to manage n8n workflows, providing tools for workflow management and execution management.

developer_tools
mcp-sequentialthinking-tools

mcp-sequentialthinking-tools

4.5

by spences10

An adaptation of the MCP Sequential Thinking Server designed to guide tool usage in problem-solving by breaking down complex problems into manageable steps.

developer_tools
evm-mcp-server

evm-mcp-server

4.5

by mcpdotdirect

A comprehensive Model Context Protocol (MCP) server that provides blockchain services across multiple EVM-compatible networks.

finance
mcp-server

mcp-server

4.5

by e2b-dev

The E2B MCP Server enables code interpreting capabilities for the Claude Desktop app using the E2B Sandbox.

developer_tools
mcp-server-tree-sitter

mcp-server-tree-sitter

4.5

by wrale

The MCP Tree-sitter Server is a Model Context Protocol server that provides code analysis capabilities using tree-sitter, designed to give AI assistants intelligent access to codebases with appropriate context management.

developer_tools
mcp-nixos

mcp-nixos

4.4

by utensils

MCP-NixOS is a Model Context Protocol server designed to provide accurate information about NixOS, Home Manager, and nix-darwin configurations, preventing AI assistants from generating incorrect data.

os_automation
mcp-n8n-workflow-builder

mcp-n8n-workflow-builder

4.4

by salacoste

The n8n Workflow Builder MCP Server is designed to manage n8n workflows using the Model Context Protocol, allowing seamless integration with Claude AI and Cursor IDE.

cloud_platforms
claude-code-mcp

claude-code-mcp

4.4

by auchenberg

Claude Code MCP is an implementation of Claude Code as a Model Context Protocol (MCP) server, enabling its software engineering capabilities through a standardized interface.

developer_tools
mcp-git-ingest

mcp-git-ingest

4.4

by adhikasp

A Model Context Protocol (MCP) server that helps read GitHub repository structure and important files.

developer_tools
code2prompt

code2prompt

4.4

by mufeedvh

Code2Prompt is a tool that converts your codebase into a single LLM prompt, facilitating code analysis and generation.

developer_tools
notion-mcp-server

notion-mcp-server

4.4

by awkoy

Notion MCP Server is a Model Context Protocol server implementation that enables AI assistants to interact with Notion's API, providing tools for reading, creating, and modifying Notion content through natural language interactions.

ai_chatbot
mcp-montano-server

mcp-montano-server

4.4

by lucasmontano

MCP Montano Server is a TypeScript-based server project designed to work with Node.js and npm, providing a robust environment for developing and deploying applications.

developer_tools
f2c-mcp

f2c-mcp

4.3

by f2c-ai

A Model Context Protocol server for Figma Design to Code using F2C.

developer_tools
DesktopCommanderMCP

DesktopCommanderMCP

4.3

by wonderwhy-er

Desktop Commander MCP is a tool that allows users to search, update, manage files, and run terminal commands using AI, without incurring API token costs.

file_systems
Office-PowerPoint-MCP-Server

Office-PowerPoint-MCP-Server

4.3

by GongRzhe

A MCP server for PowerPoint manipulation using python-pptx, providing tools for creating, editing, and manipulating PowerPoint presentations.

file_systems
osp_marketing_tools

osp_marketing_tools

4.3

by open-strategy-partners

A comprehensive suite of tools for technical marketing content creation, optimization, and product positioning based on Open Strategy Partners' proven methodologies.

communication
supabase-mcp

supabase-mcp

4.3

by supabase-community

Connect your Supabase projects to AI assistants using the Model Context Protocol (MCP) server.

databases
dev-mcp

dev-mcp

4.3

by Shopify

This project implements a Model Context Protocol (MCP) server that interacts with Shopify Dev, supporting various tools to interact with different Shopify APIs.

developer_tools
kicad-mcp

kicad-mcp

4.2

by lamaalrajih

This guide provides instructions for setting up a Model Context Protocol (MCP) server for KiCad, compatible with any MCP-compliant client.

developer_tools
openapi-mcp-server

openapi-mcp-server

4.2

by janwilmake

A Model Context Protocol (MCP) server for Claude/Cursor that enables searching and exploring OpenAPI specifications through oapis.org.

research_and_data
mcp-hotnews-server

mcp-hotnews-server

4.2

by wopal-cn

A Model Context Protocol (MCP) server that provides real-time hot trending topics from major Chinese social platforms and news sites.

entertainment_and_media
figma-mcp

figma-mcp

4.2

by MatthewDailey

A ModelContextProtocol server that enables AI assistants to interact with Figma files.

developer_tools
mcp-language-server

mcp-language-server

4.2

by isaacphi

The MCP Language Server is a server that facilitates the integration of language servers with Model Context Protocol (MCP) enabled clients, providing enhanced code navigation and semantic tools.

developer_tools