使用说明

项目简介

本项目提供了一个简单的MCP服务器示例，该服务器通过工具的形式提供了基本的数学运算功能，例如加法和乘法。它旨在演示如何使用 'mcp.server.fastmcp' 库构建一个基础的MCP服务器。

主要功能点

• 提供了 'add' (加法) 和 'multiply' (乘法) 两个工具。
• 使用 'stdio' (标准输入输出) 作为通信传输协议。
• 演示了 MCP 服务器的基本搭建和工具注册流程。

安装步骤

由于本仓库主要是一个客户端项目，要运行此 MCP 服务器示例，您需要先安装客户端项目所需的依赖。

1. 创建并激活虚拟环境 (可选但推荐):

   python -m venv .venv
   source .venv/bin/activate   # Linux/Mac
   .venv\Scripts\activate  # Windows
   

2. 安装依赖:

   pip install -r requirements.txt
   

服务器配置

要让 MCP 客户端（例如本仓库中的 Streamlit 客户端）连接到此数学服务器，您需要在客户端的配置文件中进行配置。客户端通常需要 MCP 服务器的启动命令和参数。

在本示例的 Streamlit 客户端项目中，配置文件为 'config/mcp_config.json'。您可以在此文件中配置名为 "math" 的服务器，配置信息如下：

{
  "math": {
    "command": "python",
    "args": ["src/api/math_server.py"]
  }
}

• 'server name' (服务器名称): "math" (客户端代码中默认使用 "math" 作为这个服务器的名称)
• 'command' (启动命令): 'python' (用于运行 Python 脚本)
• 'args' (命令参数): '["src/api/math_server.py"]' (指向 'math_server.py' 脚本的路径，相对于客户端项目根目录)

注意: 客户端项目已经默认配置了名为 "math" 的服务器，并指向了 'src/api/math_server.py'。您无需手动修改配置文件，除非您想更改服务器脚本的路径或启动方式。

基本使用方法

1. 启动 Streamlit 客户端应用: 打开终端，导航到 'streamlit_with_mcp' 仓库的根目录，并运行 Streamlit 应用：

   streamlit run main.py
   

   Streamlit 客户端应用启动后，会自动尝试连接并启动配置中定义的 MCP 服务器（包括 "math" 服务器）。

2. 在 Streamlit UI 中启用 "math" 工具: 在 Streamlit 应用的侧边栏 "⚙️ MCP 설정 목록" 中，找到 "math (stdio)" 配置项，并确保其 "✅ 使用" 复选框处于选中状态。默认情况下，"math" 工具应该是启用的。

3. 与聊天机器人交互，使用数学工具: 在聊天输入框中输入问题，例如 "5 加 3 等于多少？" 或 "7 乘以 9 是多少？"。当问题需要进行数学计算时，客户端的聊天机器人会调用 "math" 服务器提供的 'add' 或 'multiply' 工具来完成计算并给出答案。

简而言之，您只需运行 Streamlit 客户端应用，并确保 "math" 工具已启用，即可体验这个简单的数学工具 MCP 服务器。