Metadata-Version: 2.4
Name: web-tool-mcp-server
Version: 0.0.2
Summary: linview's MCP server tools for web utilities
Home-page: https://github.com/linview/sandbox_agent
Author: linview
Author-email: linview <linview@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/linview/sandbox_agent
Project-URL: Repository, https://github.com/linview/sandbox_agent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastmcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: requests>=2.28.0
Requires-Dist: beautifulsoup4>=4.11.0
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# Web Tool MCP Server

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

## 功能特性

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

## 安装

### 从源码安装

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

# 安装依赖
pip install -e .
```

### 从PyPI安装（发布后）

```bash
pip install web-tool-mcp-server
```

## 使用方法

### 命令行使用

```bash
# 直接运行
python -m web_tool.server

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

### 在Cursor中配置

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

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

或者如果通过pip安装：

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

## 可用工具

### 1. get_web_page

获取网页内容

**参数:**
- `url` (str): 要获取的网页URL

**返回:**
- 网页的标题和文本内容

**示例:**
```python
result = get_web_page("https://example.com")
```

### 2. search_web_content

在网页内容中搜索关键词

**参数:**
- `url` (str): 要搜索的网页URL
- `search_term` (str): 搜索关键词

**返回:**
- 包含关键词的上下文内容

**示例:**
```python
result = search_web_content("https://example.com", "python")
```

## 开发

### 项目结构

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

### 本地开发

```bash
# 安装开发依赖
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)
