py-mcp-sse

py-mcp-sse

6

This project provides a sample implementation of an MCP client and server using Python. It demonstrates a decoupled server-client architecture via SSE compatible with cloud-native applications, featuring a book search tool utilizing the Gutenberg Project API.

Overview

  • Project: An implementation of an MCP client and server in Python, based on the Model Context Protocol.
  • MCP Server: Offers a book search tool via the Gutenberg Project API, adapted from an example STDIO server from MCP documentation.
  • MCP Client: Connects and utilizes tools provided by the SSE-based MCP server, adapted from an example STDIO client from MCP documentation.
  • System Requirements: Python 3.13 or higher, and uv or pip package manager.
  • Installation: Clone the repository, configure the environment using uv or pip, set environment variables.
  • Features: Decoupled server and client processes suitable for cloud-native use cases, as opposed to STDIO-based mode.
  • Troubleshooting: Ensure correct Python version, environment variables, dependency installation, and port usage.