使用说明

项目简介

本项目 'ai-playground' 仓库包含一个简单的 MCP (Model Context Protocol) 服务器实现示例。该示例服务器名为 "Add"，提供了一个 'add' 工具，用于执行两个数字的加法运算。此示例旨在演示如何使用 'fastmcp' 框架快速构建 MCP 服务器，并提供一个可供 MCP 客户端调用的工具。

主要功能点

MCP 服务器: 实现了基础的 MCP 协议，能够响应客户端的请求。
工具注册与执行: 注册了一个名为 'add' 的工具，客户端可以调用此工具执行加法运算。
快速启动: 使用 'fastmcp' 框架，服务器代码简洁，易于理解和启动。

安装步骤

克隆仓库: 首先，您需要克隆 'ai-playground' GitHub 仓库到本地。

git clone https://github.com/automata/ai-playground.git
cd ai-playground

创建并激活虚拟环境: 建议在虚拟环境中运行，以隔离项目依赖。

python3 -m venv venv
. venv/bin/activate

安装依赖: 安装项目所需的 Python 依赖包。

pip install -r requirements.txt

服务器配置

MCP 客户端需要配置以下信息才能连接到此 MCP 服务器。配置信息为 JSON 格式，通常在客户端的服务器配置中设置：

{
  "server name": "Add",  // MCP 服务器的名称，这里为 "Add"
  "command": "python",   // 启动服务器的命令，这里使用 python 解释器
  "args": ["mcp_server_add.py"] // 启动服务器的命令参数，指定运行 mcp_server_add.py 脚本
}

'server name': 服务器名称，由 'FastMCP("Add")' 指定。
'command': 运行服务器的命令，通常为 'python' 或 'node' 等解释器。
'args': 命令参数，对于 Python 服务器，通常是服务器脚本的文件名。

基本使用方法

启动 MCP 服务器: 在终端中，进入仓库目录，并运行以下命令启动 'mcp_server_add.py' 服务器。
```
python mcp_server_add.py
```
服务器默认监听标准输入和输出 (stdio)。
使用 MCP 客户端: 您可以使用任何兼容 MCP 协议的客户端连接到该服务器。仓库中 'openrouter_mcp.py' 文件提供了一个使用 Python SDK 编写的简单客户端示例，可以参考该示例进行客户端开发和测试。客户端需要配置上述 服务器配置 信息，才能正确连接和调用服务器提供的工具。
调用 'add' 工具: 客户端连接成功后，可以向服务器发送 JSON-RPC 请求，调用 'add' 工具并传递参数 'a' 和 'b'，服务器将返回加法运算的结果。具体请求格式请参考 MCP 协议文档和客户端 SDK 的使用说明。

关键词