Web Tool MCP Server

一个基于FastMCP框架的Web工具MCP服务器，提供网页内容获取和搜索功能。

功能特性

• 网页内容获取: 获取指定URL的网页内容
• 内容搜索: 在网页内容中搜索特定关键词
• HTML解析: 自动解析HTML并提取文本内容
• 错误处理: 完善的错误处理和超时机制

安装

从源码安装

# 克隆项目
git clone https://github.com/linview/sandbox_agent.git
cd sandbox_agent/mcp/web_tool

# 安装依赖
pip install -e .

从PyPI安装（发布后）

pip install web-tool-mcp-server

使用方法

命令行使用

# 直接运行
python -m web_tool.server

# 或使用安装的命令
web-tool-server

在Cursor中配置

在Cursor的MCP配置文件中添加：

{
  "web-tools": {
    "command": "python",
    "args": ["-m", "web_tool.server"]
  }
}

或者如果通过pip安装：

{
  "web-tools": {
    "command": "web-tool-server"
  }
}

可用工具

1. get_web_page

获取网页内容

参数:

• url (str): 要获取的网页URL

返回:

• 网页的标题和文本内容

示例:

result = get_web_page("https://example.com")

2. search_web_content

在网页内容中搜索关键词

参数:

• url (str): 要搜索的网页URL
• search_term (str): 搜索关键词

返回:

• 包含关键词的上下文内容

示例:

result = search_web_content("https://example.com", "python")

开发

项目结构

web_tool/
├── src/
│   └── web_tool/
│       ├── __init__.py
│       └── server.py
├── setup.py
├── pyproject.toml
└── README.md

本地开发

# 安装开发依赖
pip install -e .

# 运行测试
python -m web_tool.server

# 构建包
python -m build

# 检查包
twine check dist/*

依赖

• fastmcp >= 1.0.0
• pydantic >= 2.0.0
• requests >= 2.28.0
• beautifulsoup4 >= 4.11.0

许可证

MIT License

作者

linview (linview@gmail.com)