Simple MCP Client

Name: Simple MCP Client
Author: guolisen

@guolisen

Simple MCP Client について

A simple command-line MCP (Model Context Protocol) client for testing MCP servers using Python. It supports chatting with various LLM providers and connecting to multiple MCP servers.

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

guolisen

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "simple_mcp_client": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Simple MCP Client?

Simple MCP Client is a Python command-line client for testing MCP (Model Context Protocol) servers. It supports chatting with various LLM providers and connecting to multiple MCP servers via SSE and stdio protocols, making it ideal for developers building and debugging MCP server integrations.

How to use Simple MCP Client?

Install via pip install simple-mcp-client or use UV, then configure a JSON file at ~/.config/simple_mcp_client/config.json (Linux/macOS) or %APPDATA%\simple_mcp_client\config.json (Windows). Start the client by running simple-mcp-client or python -m simple_mcp_client.main. Use commands like connect, chat, execute, and help to interact with MCP servers and LLM models.

Key features of Simple MCP Client

Connect to multiple MCP servers (SSE and stdio)
Integrate with Ollama, DeepSeek, OpenAI, and OpenRouter
Interactive command-line interface with auto-completion
Chat mode with ReAct agent for intelligent tool use
Execute tools directly with execute command
View available tools, resources, and prompts

Use cases of Simple MCP Client

Test and debug individual MCP servers interactively
Chain multiple MCP server tools for multi-step problem solving
Build prototypes that combine LLM reasoning with server tool execution
Explore available resources and prompts from connected MCP servers
Automate tool execution in development workflows

FAQ from Simple MCP Client

Where is the configuration file stored?

On Linux/macOS it is stored at ~/.config/simple_mcp_client/config.json; on Windows it is at %APPDATA%\simple_mcp_client\config.json. The client copies a default configuration if the file does not exist.

What are the runtime requirements?

Python 3.12 or higher is required. The client uses additional dependencies listed in the project's requirements.txt.

How do I connect to an MCP server?

Use the connect <server_name> command. The server must be defined in the configuration file under mcpServers, specifying its type (sse or stdio) and connection details.