FindMCP Logo FindMCP.info
MCP Hello World Example

MCP Hello World Example

site icon
2025.04.02 0
PythonMCP协议示例函数调用演示开发效率
MCP-template 是一个基于 Flask 和 OpenAI 集成的 Model Context Protocol (MCP) 服务器示例项目。它展示了如何创建一个 MCP 服务器，提供数字加法功能，并通过 OpenAI 的函数调用能力让客户端使用该功能。
View on GitHub

Overview

基本能力

产品定位

MCP-template 是一个用于演示 MCP 协议实现的示例项目，主要用于展示如何通过 Flask 服务器和 OpenAI 集成来实现函数调用功能。

核心功能

  • 实现了一个简单的数字加法函数 (add_numbers)
  • 提供了 MCP 协议端点，用于函数列表和执行
  • 集成了 OpenAI 的 API，支持函数调用能力
  • 提供了 JSON schema 定义用于加法函数

适用场景

  • 开发人员学习 MCP 协议实现
  • 展示 OpenAI 函数调用能力的示例
  • 快速搭建一个支持函数调用的 MCP 服务器

工具列表

  • server.py: MCP 服务器实现，提供加法函数和 MCP 协议端点
  • client.py: 客户端实现，集成 OpenAI API 并演示函数调用

常见问题解答

  • 无

使用教程

使用依赖

  • Python 3.x
  • OpenAI API key

安装教程

  1. 克隆仓库
  2. 安装依赖:
pip install -r requirements.txt
  1. 设置 OpenAI API key:
export OPENAI_API_KEY="your-api-key-here"

调试方式

  1. 启动 MCP 服务器:
python server.py
  1. 在另一个终端运行客户端:
python client.py

客户端将: 1. 连接到 MCP 服务器 2. 获取可用函数 3. 与 OpenAI 模型开始对话 4. 通过加法函数演示函数调用 (42 和 17) 5. 显示结果

项目结构

.
├── README.md           # 项目文档
├── requirements.txt    # Python 依赖
├── server.py          # MCP 服务器实现
└── client.py          # OpenAI 客户端实现

依赖

  • python-dotenv: 环境变量管理
  • openai: OpenAI API 客户端
  • flask: Web 服务器框架
  • requests: HTTP 客户端库

许可证

None