MCP Demo

@syuchua

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

syuchua

关于 MCP Demo

一个MCP的demo，支持本地和在线servers

MCP Demo 配置

暂无标准配置

该服务器的 README 中没有可解析的 MCP 配置块，请前往代码仓库查看安装说明。

代码仓库

MCP Demo 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

常见问题

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.

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`.

其他分类下的更多 MCP 服务器

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K