mcp-open-client

# MCP Open Client [](https://badge.fury.io/py/mcp-open-client) [](https://www.python.org/downloads/) [](https://opensource.org/licenses/MIT) A powerful Python client and REST API for the Model Context Protocol (MCP), enabling seamless integration with MCP servers and AI providers. ## Features - **FastAPI REST API** - Full-featured API server for managing MCP servers - **Rich CLI** - Beautiful command-line interface with colored output - **AI Provider Integration** - Support for OpenAI, Anthropic, and custom providers - **Process Management** - Automatic lifecycle management for MCP servers - **Tool Discovery** - Automatic detection and execution of MCP server tools - **Conversation Management** - Persistent conversation storage and retrieval - **Type Safe** - Full type hints with Pydantic v2 ## Installation ### From PyPI (Recommended) ```bash pip install mcp-open-client ``` ### From Source ```bash git clone https://github.com/alejoair/mcp-open-client-v2.git cd mcp-open-client-v2 pip install -e . ``` ## Quick Start ### 1. Start the API Server ```bash mcp-open-client api serve --port 8001 ``` The API server will be available at: - **API**: http://localhost:8001 - **Swagger Docs**: http://localhost:8001/docs - **ReDoc**: http://localhost:8001/redoc ### 2. Add an MCP Server ```bash mcp-open-client api add \ --name "filesystem" \ --command "npx" \ --args "-y" \ --args "@modelcontextprotocol/server-filesystem" \ --args "." ``` ### 3. Start the Server ```bash mcp-open-client api start <server-id> ``` ### 4. List Available Tools ```bash mcp-open-client api tools <server-id> ``` ## CLI Reference ### Direct Connection Commands Connect directly to MCP servers without the API: ```bash # Connect and test mcp-open-client connect http://localhost:3000 # …