What does mcp-demo do?
It is a demo MCP client-and-server implementation that lets you interact with multiple tools (weather, map, file search, system control) through a single CLI, with automatic server selection.
MCP Demo
@syuchua
Basic information
About MCP Demo
一个MCP的demo，支持本地和在线servers
MCP Demo config
No standard config provided
This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.
RepositoryMCP Demo tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is mcp-demo?
mcp-demo is a demo MCP (Model Context Protocol) implementation that includes an MCP client and multiple MCP servers. It supports local file search, system control, command execution, and online API calls, designed for developers exploring MCP with tools like weather, map services, file search, and system utilities.
How to use mcp-demo?
Clone the repository, install dependencies with uv pip install -e ., optionally configure an OpenAI API key in a .env file or directly in src/config/default_config.yaml, then run python main.py or uv run main.py to start the interactive CLI. Type queries or use commands like !help, !servers, !connect <server>, !models, !model <name>, !debug <on/off>, and !quit/!exit.
Key features of mcp-demo
- Intelligent server selection based on query content
- US weather forecasts and alerts via NWS
- Amap (高德地图) geocoding, weather, route planning, and POI search
- Everything-based local file search with advanced syntax
- System tools: execute programs, manage processes, read/write files, and run Python code
Use cases of mcp-demo
- Ask for weather forecasts or alerts for US locations
- Query map data (geocoding, weather, routes, POIs) for Chinese locations via Amap
- Search local files using Everything engine with wildcards or regular expressions
- Control system applications: open apps, manage processes, create/edit files, and execute code
Frequently asked questions
What are the runtime requirements?
Python 3.12 (3.11 and 3.10 likely work as well) and the `uv` package manager.
How do I configure API keys?
Create a `.env` file with `OPENAI_API_KEY="your-api-key"` or directly edit `src/config/default_config.yaml`.
What servers are included?
weather (US National Weather Service), 高德 (Amap), everything (local file search via Everything engine), and system_tools (program execution, file operations, process management, code execution).
How do I use the interactive client?
After starting with `python main.py`, type your query or use commands: `!help`, `!servers`, `!connect <server>`, `!models`, `!model <name>`, `!debug <on/off>`, `!quit`/`!exit`.
More Other MCP servers
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
16.7K
Lemon.io
lemon-ioRequest dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
22.0K
Soar Flight Booking MCP
Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.
Yuppsy
Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code
Comments