MCP 服务器

MCP Web Tools Server

一个模型上下文协议服务器，允许大型语言模型通过标准化工具与网络内容交互，目前支持网页抓取功能。

README

MCP Web 工具服务器

一个模型上下文协议 (MCP) 服务器，提供用于 Web 相关操作的工具。该服务器允许 LLM 通过标准化工具与 Web 内容进行交互。

当前工具

web_scrape: 将 URL 转换为使用 r.jina.ai 作为前缀，并返回 markdown 内容

安装

克隆此仓库：
```
git clone <repository-url>
cd MCP
```
安装所需的依赖项：
```
pip install -r requirements.txt
```
或者，您可以使用 uv 来更快地安装：
```
uv pip install -r requirements.txt
```

运行服务器和 UI

此仓库包含方便的脚本来运行 MCP 服务器或 Streamlit UI。

使用运行脚本

在 macOS/Linux 上：

# 使用 stdio 传输运行服务器（默认）
./run.sh server

# 使用 SSE 传输运行服务器
./run.sh server --transport sse --host localhost --port 5000

# 运行 Streamlit UI
./run.sh ui

在 Windows 上：

# 使用 stdio 传输运行服务器（默认）
run.bat server

# 使用 SSE 传输运行服务器
run.bat server --transport sse --host localhost --port 5000

# 运行 Streamlit UI
run.bat ui

手动运行

或者，您可以直接运行服务器：

使用 stdio（默认）

python server.py

使用 SSE

python server.py --transport sse --host localhost --port 5000

这将在 localhost:5000 上启动一个 HTTP 服务器，该服务器接受 MCP 连接。

要手动运行 Streamlit UI：

streamlit run streamlit_app.py

使用 MCP Inspector 进行测试

MCP Inspector 是一个用于测试和调试 MCP 服务器的工具。您可以使用它与您的服务器进行交互：

安装 MCP Inspector：

npm install -g @modelcontextprotocol/inspector

使用您的服务器运行 Inspector：

npx @modelcontextprotocol/inspector python server.py

使用 Inspector 界面，通过提供类似 example.com 的 URL 并查看返回的 markdown 内容来测试 web_scrape 工具。

与 Claude for Desktop 集成

要将此服务器与 Claude for Desktop 一起使用：

确保您已安装 Claude for Desktop。
打开 Claude for Desktop 配置文件：
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
添加以下配置（根据需要调整路径）：

{
  "mcpServers": {
    "web-tools": {
      "command": "python",
      "args": [
        "/absolute/path/to/MCP/server.py"
      ]
    }
  }
}

重新启动 Claude for Desktop。
您现在应该在 Claude 的界面中看到 web_scrape 工具可用。您可以要求 Claude 从网站获取内容，它将使用该工具。

使用示例

与 Claude 集成后，您可以提出如下问题：

"example.com 的主页上有什么？"
"你能获取并总结 mozilla.org 的内容吗？"
"获取 wikipedia.org/wiki/Model_Context_Protocol 的内容并向我解释。"

Claude 将使用 web_scrape 工具来获取内容并在其响应中提供它。

添加更多工具

要向此服务器添加更多工具：

在 tools/ 目录中创建一个新的 Python 文件，例如 tools/new_tool.py。
实现您的工具函数，遵循与现有工具类似的模式。
在 server.py 中导入您的工具并将其注册到 MCP 服务器：

# 导入您的新工具
from tools.new_tool import new_tool_function

# 将工具注册到 MCP 服务器
@mcp.tool()
async def new_tool(param1: str, param2: int) -> str:
    """
    描述您的工具的功能。
    
    Args:
        param1: param1 的描述
        param2: param2 的描述
        
    Returns:
        返回值描述
    """
    return await new_tool_function(param1, param2)