mcp-server-fetch-python

基本能力

产品定位

mcp-server-fetch-python 是一个专注于网页内容获取和转换的工具，旨在帮助用户从各种网页和媒体文件中提取和转换内容。

核心功能

1. get-raw-text: 直接从 URL 提取原始文本内容，无需浏览器渲染。适用于结构化数据格式或需要快速直接访问的场景。
2. get-rendered-html: 使用无头浏览器获取完全渲染的 HTML 内容。适用于现代 Web 应用程序和需要 JavaScript 渲染的单页应用。
3. get-markdown: 将网页内容转换为格式良好的 Markdown。保留结构元素的同时提供干净、可读的文本输出。
4. get-markdown-from-media: 从媒体文件（图像、视频）中执行 AI 驱动的内容提取。需要设置有效的 OPENAI_API_KEY 环境变量。

适用场景

• 从网页中提取结构化数据
• 获取需要 JavaScript 渲染的网页内容
• 将网页内容转换为 Markdown 格式
• 从图像和视频中提取文本内容

工具列表

1. get-raw-text: 直接从 URL 提取原始文本内容。
2. get-rendered-html: 获取完全渲染的 HTML 内容。
3. get-markdown: 将网页内容转换为 Markdown。
4. get-markdown-from-media: 从媒体文件中提取内容。

常见问题解答

• Q: 为什么 get-markdown-from-media 工具不起作用？ A: 需要设置有效的 OPENAI_API_KEY 环境变量。
• Q: 遇到字符编码问题怎么办？ A: 可以设置 PYTHONIOENCODING 环境变量为 "utf-8"。

使用教程

使用依赖

需要安装以下依赖：

• Python 环境
• UV 工具
• Git（用于本地安装）

安装教程

通过 Claude Desktop 使用

1. 编辑 Claude Desktop 配置文件：
2. MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
3. Windows: %APPDATA%/Claude/claude_desktop_config.json
4. 添加以下配置：

"mcpServers": {
  "mcp-server-fetch-python": {
    "command": "uvx",
    "args": [
      "mcp-server-fetch-python"
    ]
  }
}

本地安装

1. 克隆仓库：

git clone https://github.com/tatn/mcp-server-fetch-python.git
cd mcp-server-fetch-python

1. 构建项目：

uv sync
uv build

1. 添加配置到 Claude Desktop 配置文件：

"mcpServers": {
  "mcp-server-fetch-python": {
    "command": "uv",
    "args": [
      "--directory",
      "path\\to\\mcp-server-fetch-python",
      "run",
      "mcp-server-fetch-python"
    ]
  }
}

调试方式

可以使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uvx mcp-server-fetch-python

或

npx @modelcontextprotocol/inspector uv --directory path\\to\\mcp-server-fetch-python run mcp-server-fetch-python

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。