The simplest mcp project
2025.04.10
1
PythonMCP系统演示LLM服务集成其它
mcp-demo是一个最小化的MCP系统实现项目，旨在帮助用户理解MCP系统的运行机制。该项目通过使用deepseek的API_KEY或其他支持MCP服务的LLM服务，展示了如何构建和运行一个基础的MCP项目。
View on GitHub
Overview
基本能力
产品定位
mcp-demo是一个最小化的MCP系统实现项目，用于演示和理解MCP系统的基本运行机制。
核心功能
- 支持使用deepseek或其他支持MCP服务的LLM服务。
- 提供基础的MCP项目结构和运行示例。
- 支持多任务运行（如tasklist.py、weather.py、stock.js）。
适用场景
- 学习和理解MCP系统的基本运行机制。
- 快速搭建和测试基础的MCP项目。
使用教程
使用依赖
- 创建虚拟环境： ```shell uv venv
# On Windows: .venv\Scripts\activate
# On Unix or MacOS:
source .venv/bin/activate
2. 安装依赖：shell
uv add mcp openai python-dotenv
```
安装教程
- 创建.env文件并添加API_KEY：
shell touch .env echo "OPENAI_API_KEY=your_api_key" >> .env echo "OPENAI_BASE_URL="https://api.deepseek.com/v1"" >> .env echo "OPENAI_MODEL="deepseek-chat"" >> .env - 编辑server.json文件以指定mcp-server：
json { "servers": [ { "command": "uv", "args": ["run","../server/tasklist.py"], "env": null }, { "command": "uv", "args": ["run","../server/weather.py"], "env": null }, { "command": "npx", "args": ["-y","../server/stock.js"], "env": null } ] }
调试方式
- 运行mcp-demo：
shell cd client uv run client.py server.json - 输入用户query进行测试。