使用说明
项目简介
Selector AI FastMCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在将 Selector AI 的强大功能以标准化的方式提供给大型语言模型 (LLM) 客户端。该服务器允许 LLM 通过简单的 JSON-RPC 接口调用 Selector AI 的能力,例如提问并获取答案。
主要功能点
- MCP 兼容服务器: 实现了基本的 MCP 协议,能够接收和处理来自 MCP 客户端的请求。
- Selector AI 集成: 内置了与 Selector AI 服务的集成,可以将用户的问题转发给 Selector AI 获取答案。
- 工具调用: 支持 'tools/call' 方法,允许客户端调用预定义的工具,例如 'ask_selector' (向 Selector AI 提问)。
- Stdin/Stdout 通信: 使用标准输入和标准输出进行 JSON 格式的请求和响应通信,易于集成到各种环境中。
- Docker 部署: 提供 Dockerfile,方便用户快速部署和运行服务器。
安装步骤
- 克隆仓库:
git clone https://github.com/automateyournetwork/selector-mcp-server cd selector-ai-mcp - 安装 Python 依赖:
pip install -r requirements.txt - 配置环境变量:
- 创建 '.env' 文件,并填入 Selector AI 的 API URL 和 API Key:
请替换 'https://your-selector-api-url' 和 'your-api-key' 为您实际的 Selector AI 服务地址和 API 密钥。SELECTOR_URL=https://your-selector-api-url SELECTOR_AI_API_KEY=your-api-key
- 创建 '.env' 文件,并填入 Selector AI 的 API URL 和 API Key:
- 构建 Docker 镜像 (可选):
docker build -t selector-mcp .
服务器配置
对于 MCP 客户端,您需要配置连接到 Selector AI FastMCP Server 的信息。以下是一个典型的 JSON 配置示例,用于描述如何启动和连接到该服务器:
{ "serverName": "selector-ai-mcp-server", "command": "python", "args": ["mcp_server.py"] }
- 'serverName': 服务器的名称,您可以自定义,用于在 MCP 客户端中标识该服务器。
- 'command': 启动服务器的命令。这里使用 'python' 解释器来运行 'mcp_server.py' 脚本。
- 'args': 传递给启动命令的参数。这里指定要运行的服务器脚本为 'mcp_server.py'。
重要: 请确保在运行服务器之前,已经正确设置了 'SELECTOR_URL' 和 'SELECTOR_AI_API_KEY' 环境变量。
基本使用方法
- 启动服务器:
- 您可以直接在本地运行 'python mcp_server.py' (确保已配置环境变量),或者使用 Docker 运行构建好的镜像。
- 发送请求:
- MCP 客户端需要通过标准输入 (stdin) 以 JSON 格式发送请求给服务器。
- 例如,要调用 'ask_selector' 工具提问,可以发送以下 JSON 请求:
{"method": "tools/call", "tool_name": "ask_selector", "content": "What is AIOps?"}
- 接收响应:
- 服务器会将 JSON 格式的响应通过标准输出 (stdout) 返回给 MCP 客户端。
- 响应内容会包含 Selector AI 的回答或其他工具执行结果。
示例交互
客户端发送请求到服务器 (stdin):
{"method": "tools/call", "tool_name": "ask_selector", "content": "What is cloud computing?"}
服务器返回响应 (stdout):
{"content": "Cloud computing is the on-demand availability of computer system resources, especially data storage and computing power, without direct active management by the user. The term is generally used to describe data centers available to many users over the Internet."}
信息
分类
AI与计算