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.