模型上下文协议演示

一个使用FastMCP框架实现的MCP服务器,包含工具、资源和提示功能,用于AI模型与工具间的通信。

  • by yu9824
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 yu9824/mcp-tutorial

使用说明

MCP教程

该项目是一个使用模型上下文协议(MCP)的简单演示。它使用FastMCP框架实现了包含工具、资源和提示的MCP服务器。

功能

工具 (Tools)

  • 角色执行操作,进行处理或计算
  • **例(举例)**将两个数值相加 add 函数
  • 用途计算处理、数据转换、外部API调用、文件操作等

资源 (Resources)

  • 角色提供动态数据和内容
  • 例如生成个性化的问候信息 greeting://{name} 资源
  • 用途数据库访问、文件读取、获取设置信息、获取API数据等

提示(Prompts)

  • 角色生成针对AI模型的指令和模板
  • 例如生成各种风格的问候提示 greet_user 提示
  • 用途聊天机器人的响应生成、文档创作辅助、翻译、摘要等AI任务

设置

1. 环境搭建

conda create -yn mcp312 python=3.12 --file ./requirements.txt

2. 环境激活

conda activate mcp312

使用方法

服务器启动

# 直接実行
python3 server.py

# または、serve.shスクリプトを使用
./serve.sh

客户端执行

python3 client.py

运行客户端后,以下测试将自动执行:

  1. 显示可用工具列表
  2. add 工具执行测试(5+3=8)
  3. 列出可用资源
  4. greeting://Alice 资源读取测试
  5. 显示可用提示列表
  6. greet_user 提示执行测试

文件结构

  • server.pyMCP服务器的实现(使用FastMCP框架)
  • client.pyMCP客户端的实现与测试
  • serve.sh用于启动服务器的shell脚本
  • requirements.txtPython依赖项
  • LICENSE许可证文件

技术栈

  • Python 3.12
  • FastMCP用于MCP服务器实现的框架
  • **MCP(模型上下文协议)**AI模型与工具间的通信协议

许可证

关于此项目的许可信息LICENSE 请参阅文件。