MCP服务器与客户端示例(含Gemini函数调用)

一个展示MCP协议最小实现及Gemini函数调用的示例项目,用于让AI模型自动选择并调用外部工具API。

  • by yokoba
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 yokoba/mcp-server-sample

使用说明

简单的MCP服务器和客户端示例(带Gemini函数调用)

概要

  • MCP(模型上下文协议)とは?
    机器学习模型AI使代理调用外部工具(API)的协议。

  • 本存储库的目的

    • 「MCP服务器客户端的最小配置是怎么做的?」
    • 「LLM(Gemini)我想让你自动选择用哪个工具。“
      的备忘录。

文件配置

  • mcp_simple_server1.py
    MCP服务器的最小示例。

  • mcp_simple_client1.py
    MCP客户端的最小示例(用于连接确认)。

  • mcp_simple_server2.py
    MCP服务器的最小示例。
    greet/farewell 两个tool准备。

  • mcp_simple_client2.py
    Gemini function calling使用MCP客户。
    LLM根据时间自动greet在工作空间的边缘farewell,然后调用服务器。


実行环境

  • Python 3.13(3.10以上的话应该会动作)
  • fastmcp >= 2.5.2
  • 谷歌genai >= 1.18.0
  • 紫外线 (即使没有也能工作,但为了高速化而推荐)

安装和运行

  1. 安装所需的软件包
uv init
uv add google-genai
uv add fastmcp
  1. Gemini API按键获取环境变量GEMINI_API_KEY设置为
    (谷歌AI工作室で無料発行可能)

  2. 启动服务器客户端示例

  • 单独启动服务器(例)

    python mcp_simple_client1.py
    
  • 客户端+Gemini协作执行(例)

    python mcp_simple_client2.py
    

使用方法

  • 所有示例代码都可复制。
  • Gemini的,之function calling按时间tool选择LLM委托。

注意

  • 错误处理和异常处理优先考虑简单性。
  • 在实际的业务服务实施中,请添加适当的验证、日志和异常处理。

许可证

MIT许可证等自由。
用于备忘录和样品。请自己负责使用。