使用说明

项目简介

URL-Based MCP服务器演示项目是一个概念验证性质的MCP服务器实现，旨在让用户无需编写或托管代码，通过URL配置即可快速搭建和体验MCP服务器。它主要用于协议理解、安全实验和功能演示，而非构建生产级别的MCP集成方案。该服务器允许用户通过简单的Web界面配置工具，并通过URL获取MCP客户端所需的配置信息。

主要功能点

免代码配置: 通过Web界面和URL参数配置服务器，无需编写任何后端代码。
工具管理: 支持配置和管理工具 (Tools)，包括静态文本响应和HTTP Endpoint调用两种类型。
动态HTTP工具: 允许配置调用外部HTTP Endpoint的工具，实现动态功能扩展。
SSE通信: 使用Server-Sent Events (SSE) 协议与MCP客户端进行通信。
演示性质: 专注于展示MCP协议的核心概念和功能，便于理解和实验。

安装步骤

由于该项目主要以在线演示和URL配置为核心，本地部署并非主要使用方式。但如果需要本地运行和修改，可以按照以下步骤操作：

克隆仓库: 将仓库克隆到本地：

git clone https://github.com/sshh12/mcp-demo.git
cd mcp-demo/backend

安装依赖: 安装Python依赖：

pip install -r requirements.txt

运行服务器: 启动Flask服务器：
```
python main.py
```
服务器默认会在 'http://0.0.0.0:5000' 启动。

服务器配置

该MCP服务器的核心特点是通过URL进行配置，主要通过访问 https://url-mcp-demo.sshh.io/ 在线演示站点进行配置。

MCP客户端配置信息 (重要):

MCP客户端需要配置连接到该MCP服务器的地址。对于 URL-Based MCP服务器，客户端需要配置的 服务器地址 (command) 是服务器提供的 SSE Endpoint URL。

访问演示站点: 打开 https://url-mcp-demo.sshh.io/。
配置工具: 在Web界面上添加和配置所需的工具 (Tools)。你可以选择 "static text response" (静态文本响应) 或 "http post endpoint" (HTTP POST Endpoint) 类型的工具。
获取MCP配置: 配置完成后，复制页面上显示的 "MCP Configuration"。这实际上是服务器的配置信息，重要的是其中的 SSE Endpoint URL。

MCP客户端需要使用的配置信息 (JSON 格式示例):

{
  "serverName": "URL-Based MCP Server Demo",
  "command": "<服务器SSE Endpoint URL>",
  "args": []
}

其中， '<服务器SSE Endpoint URL>' 需要替换为你在演示站点上获取的 SSE Endpoint URL。例如，如果本地运行服务器，并且没有使用config参数，那么 '<服务器SSE Endpoint URL>' 可能是 'http://localhost:5000/sse'。如果是通过在线演示站点配置并获取的，则会是一个类似 'https://url-mcp-demo.sshh.io/sse?config=xxxxxxxx' 的URL。

注意: 'args' 字段在此演示服务器中通常为空，因为配置主要通过URL和Web界面完成。客户端主要需要配置正确的 'command' (即 SSE Endpoint URL) 来连接服务器。

基本使用方法

启动服务器: 如果本地运行，按照安装步骤启动服务器。如果使用在线演示站点，则无需本地启动。
配置服务器: 通过 https://url-mcp-demo.sshh.io/ 网站配置工具。
配置MCP客户端: 将获取到的 SSE Endpoint URL 配置到你的MCP客户端中，并确保 'serverName' 与配置一致。
客户端连接与交互: 启动MCP客户端，客户端将连接到配置的MCP服务器，并可以调用配置的工具等功能。

示例场景: 可以使用该演示服务器进行 MCP 协议的简单测试和学习，例如，配置一个返回固定文本的工具，然后在MCP客户端中调用该工具，验证客户端与服务器的通信和工具调用流程。也可以尝试配置 HTTP Endpoint 工具，连接到 'https://webhook.site/' 等服务，实现更动态的工具功能演示。

关键词