π¦
Egile MCP Client
A comprehensive MCP client with direct connection and AI agent modes, including web interface
0 installs
Trust: 47 β Fair
Devtools
Installation
npx egile-mcp-clientAsk AI about Egile MCP Client
Powered by Claude Β· Grounded in docs
I know everything about Egile MCP Client. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Egile MCP Client
A comprehensive Model Context Protocol (MCP) client that provides two operational modes and a web interface for interacting with MCP servers.
Features
- Two Operation Modes:
- Direct Mode: Connect directly to MCP server tools and resources
- Agent Mode: Use a generic AI agent that works with any MCP server
- Multiple Interfaces:
- Terminal CLI: Command-line interface for both modes
- Web Chat Interface: Browser-based chatbot with conversation history
- AI Provider Support: OpenAI, Anthropic Claude, xAI Grok, and extensible for other providers
- Conversation History: Persistent chat history across sessions
- Real-time Communication: WebSocket support for live interactions
Quick Start
Installation
# Install dependencies
pip install -e .
# Or using poetry
poetry install
Configuration
Create a config.yaml file:
# AI Providers (for agent mode)
ai_providers:
openai:
api_key: "your-openai-api-key"
model: "gpt-4"
anthropic:
api_key: "your-anthropic-api-key"
model: "claude-3-sonnet-20240229"
xai:
api_key: "your-xai-api-key"
model: "grok-3"
# MCP Servers
mcp_servers:
- name: "example_server"
url: "http://localhost:8000"
type: "http"
- name: "local_server"
command: ["python", "/path/to/server/main.py"]
type: "stdio"
# Default settings
default_ai_provider: "openai"
web_interface:
host: "localhost"
port: 8080
Usage
Terminal Interface
# Direct mode - connect directly to MCP server
egile-mcp-client direct --server example_server
# Agent mode - use AI agent with MCP tools
egile-mcp-client agent --provider openai
# List available tools from a server
egile-mcp-client tools --server example_server
# Interactive chat in terminal
egile-mcp-client chat --mode agent --provider openai
Web Interface
# Start the web server
egile-mcp-client web
# Then open http://localhost:8080 in your browser
Architecture
egile-mcp-client/
βββ egile_mcp_client/
β βββ __init__.py
β βββ cli.py # Command-line interface
β βββ config.py # Configuration management
β βββ mcp/
β β βββ __init__.py
β β βββ client.py # MCP client implementation
β β βββ connection.py # Connection management
β β βββ protocol.py # MCP protocol handling
β βββ agents/
β β βββ __init__.py
β β βββ base.py # Base agent interface
β β βββ openai_agent.py # OpenAI implementation
β β βββ anthropic_agent.py # Anthropic implementation
β βββ web/
β β βββ __init__.py
β β βββ app.py # FastAPI web application
β β βββ routes.py # API routes
β β βββ static/ # Static files (CSS, JS)
β β βββ templates/ # HTML templates
β βββ utils/
β βββ __init__.py
β βββ history.py # Conversation history
β βββ logging.py # Logging utilities
βββ tests/
βββ config.example.yaml
βββ README.md
License
MIT License
