MCP Simple Demo

基本能力

产品定位

mcp-simple-demo 是一个用于演示 Model Context Protocol (MCP) 的简单项目，旨在展示如何通过 MCP 实现 AI 模型与外部工具的交互。

核心功能

• 提供 MCP 兼容的服务器工具
• 支持客户端与服务器的交互
• 包含工具调用和响应的示例

适用场景

• AI 模型需要访问外部工具和数据源的场景
• 开发者学习 MCP 协议的示例项目
• 快速验证 MCP 工具调用的原型开发

工具列表

1. hello_world：返回问候消息
2. 参数：name（可选，默认值为 "World"）

3. 返回：包含问候消息的 JSON 对象

4. add：加法工具

5. 参数：a（第一个数字），b（第二个数字）
6. 返回：两个数字的和

常见问题解答

• 如何启用调试日志？
• 使用 DEBUG_LEVEL=DEBUG python server.py 命令启动服务器
• 如何全面调试？
• 使用 DEBUG=true DEBUG_LEVEL=DEBUG python server.py 命令启动服务器

使用教程

使用依赖

• Python 3.8+
• pip

安装教程

1. 克隆仓库：

git clone https://github.com/arjunprabhulal/mcp-simple-demo.git
cd mcp-simple-demo

1. 安装依赖包：

pip install -r requirements.txt

或者手动安装：

pip install mcp llama-index llama-index-tools-mcp requests

调试方式

启动服务器：

python server.py

启用调试日志：

DEBUG_LEVEL=DEBUG python server.py

全面调试模式：

DEBUG=true DEBUG_LEVEL=DEBUG python server.py

客户端交互：

python client.py

列出可用工具：

python client.py tools

调用 hello_world 工具：

python client.py hello
python client.py hello "Your Name"

调用 add 工具：

python client.py add 5 3

许可证

None