内容
# lmstudio-web-mcp
一个小型、本地的MCP服务器，为LM Studio模型（或任何MCP客户端）提供实时的互联网访问 — 网页搜索和页面阅读 — **无需API密钥**。
## 工具列表
| 工具 | 功能 |
|------|--------------|
| `web_search(query, max_results=5)` | 通过[`ddgs`](https://pypi.org/project/ddgs/)搜索网页（多引擎，无需密钥），返回标题、网址和摘要。 |
| `fetch_url(url, max_chars=8000)` | 下载页面并返回其可读文本（去除脚本、导航和模板）。 |
| `search_and_read(query, num_pages=2, max_chars=4000)` | 在一次调用中搜索**并**读取顶部结果 — 为小型模型提供便捷操作。 |
## 要求
- [`uv`](https://docs.astral.sh/uv/)（为您处理虚拟环境和Python）
- Python 3.11+（如果缺少，uv会自动获取）
## 安装
```bash
git clone https://github.com/ardhifnoor/lmstudio-web-mcp.git
cd lmstudio-web-mcp
uv sync
```
## 与LM Studio配合使用
将以下内容添加到LM Studio的`mcp.json`（设置 ▸ 程序，或 `~/.lmstudio/mcp.json`），
使用**绝对路径**：
```json
{
"mcpServers": {
"web-browser": {
"command": "/绝对路径/to/lmstudio-web-mcp/.venv/bin/python",
"args": ["/绝对路径/to/lmstudio-web-mcp/server.py"]
}
}
}
```
将`command`直接指向项目自己的`.venv/bin/python`可以避免PATH问题和LM Studio启动服务器时的同步延迟。然后重启LM Studio，启用`web-browser`服务器，并加载具有工具使用的模型。
### 推荐系统提示
小型本地模型浏览更可靠。粘贴此内容到模型的**系统提示**字段（定期更新日期 — 本地模型没有时钟）：
```
您拥有实时的互联网工具：search_and_read、web_search和fetch_url。今天的日期是YYYY-MM-DD。
- 对于任何当前的信息（“最新”、“本季/本年”、分数、价格、新闻、最近发布），您必须在回答之前调用工具。
- 优先使用search_and_read，并在查询中包含当前年份/季节。
- 信任最近日期的事实；优先使用页面的标题/信息框/摘要，而不是较旧的叙述句子。
- 以源URL和您使用的信息日期作为结尾。
```
## 注意
- **无需API密钥**。搜索使用`ddgs`，它跨多个引擎旋转并在后端速率限制或阻止时自我修复。
- MCP协议在**stdout**上运行；搜索库可能会将无害的`response: <url> 200`行打印到**stderr**（在LM Studio的日志面板中显示）。
- 与任何MCP客户端配合使用，不仅限于LM Studio。
## 许可证
MIT — 请参阅 [LICENSE](LICENSE)。
