使用说明

项目简介

本项目 'AI-from-scratch' 仓库包含多种AI基础知识和实践代码，'simple-calculator-mcp' 应用是其中一个简单的Model Context Protocol (MCP) 服务器示例。它演示了如何使用 Python 和 'mcp-server-fastmcp' 库创建一个 MCP 服务器，并提供基础的计算器功能作为工具，供支持 MCP 协议的 LLM 客户端调用。

主要功能点

提供计算工具：通过 MCP 协议暴露 'add', 'subtract', 'multiply', 'divide' 四个工具，允许 LLM 客户端执行基本的数学运算。
易于理解的示例：代码简洁明了，适合初学者学习和理解 MCP 服务器的基本概念和实现方式。
快速启动：使用 'fastmcp' 库简化了服务器的搭建过程，可以快速启动并运行。

安装步骤

克隆仓库

git clone https://github.com/XD3an/AI-from-scratch.git

进入示例目录

cd AI-from-scratch/Application/simple-calculator-mcp

安装依赖 如果你的环境中没有 'mcp-server-fastmcp' 库，请先安装：

pip install mcp-server-fastmcp

服务器配置

MCP 客户端需要配置以下 JSON 信息来连接到此服务器。请注意，此配置是客户端配置，无需用户修改 'server.py' 代码。

{
  "server_name": "MCP Calculator Server",  // 自定义服务器名称，用于客户端识别
  "command": "python",                   // 启动服务器的命令，这里使用 python 解释器
  "args": [                             // 启动命令的参数列表
    "server.py"                         // 指定要运行的服务器脚本文件
  ]
}

基本使用方法

启动服务器 在 'AI-from-scratch/Application/simple-calculator-mcp' 目录下，运行以下命令启动 MCP 服务器：
```
python server.py
```
服务器启动后，将监听 MCP 客户端的连接请求。
配置 MCP 客户端 在支持 MCP 协议的 LLM 客户端中，按照客户端的使用说明，配置服务器连接信息。将上面提供的 JSON 配置粘贴到客户端的服务器配置中。
客户端调用工具 客户端成功连接到 MCP 服务器后，即可发现并调用 'add', 'subtract', 'multiply', 'divide' 这四个工具。具体调用方式请参考 MCP 客户端的使用文档。例如，在支持自然语言工具调用的客户端中，你可以指示 LLM 执行 "计算 5 加 3" 等任务，客户端将自动调用 'add' 工具并返回结果。

关键词