noapi-google-search-mcp

关键词

本地信息服务浏览器自动化搜索工具调用框架视频转录文档读取

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了一个基于 MCP 的后端服务器，能通过 JSON-RPC 与 LLM 客户端通信，提供资源管理、工具注册与执行、以及提示模板渲染等能力。核心功能包括本地化的网页搜索、新闻订阅、YouTube 转录、文档阅读、OCR、视频裁剪、S3 上传等多种工具，全部在本地无云依赖运行。

  • 主要功能点

    • MCP 服务器核心：通过 mcp.server.fastmcp 提供工具注册、请求处理、会话管理等能力。
    • 工具集合：38 个工具覆盖网页与 API 访问、媒体处理、文档读取、云存储、订阅源等场景，均可通过 MCP 客户端调用。
    • 资源与数据管理：支持订阅源、订阅管理、内容抓取、全文检索、FTS5 索引等。
    • 本地化执行与离线能力：多数工具在本地执行或通过本地浏览器自动化完成（如 headless Chromium 的 Google 检索与 Lens/ Images 等）。
    • 运行与集成：支持通过 LM Studio、Claude Desktop、OpenClaw、Ollama 等 MCP 兼容客户端进行交互。

  • 安装步骤

    • 使用 pip 安装并安装浏览器依赖：
      • pip install noapi-google-search-mcp
      • playwright install chromium
    • 或者以源码方式安装并跳转到开发模式，确保依赖安装完成后可本地运行。

  • 服务器配置

    • MCP 客户端连接该服务器时需要提供一个配置，包含服务器名称、启动命令以及参数。下方给出示例配置（JSON 格式，便于粘贴到客户端配置中；实际客户端可按需调整名称与参数，服务器端无需额外改动）。请注意，此配置用于客户端连接服务器，其实质为启动服务器进程及传入参数，与服务器实现细节无关。
    • 示例配置（json）： { "server_name": "google-search", "command": "noapi-google-search-mcp", "args": [] }
    • 配置说明：
      • server_name：在 MCP 客户端界面显示的服务器名称，建议与仓库名称保持一致以便识别。
      • command：启动服务器的命令，当前实现提供的入口脚本为 noapi-google-search-mcp（可通过 pipx 或 python -m google_search_mcp 启动）。
      • args：启动时传递给命令的参数集合，当前实现默认无额外参数，如需调整可在此处添加。
    • 备注：MCP 客户端不需要较多前置配置即可建立连接，最关键的是提供 server_name 与启动命令信息，便于在客户端管理与调用。

  • 基本使用方法

    • 启动服务器：在支持 MCP 客户端的工作环境中，执行服务器启动命令（如 noapi-google-search-mcp）即可让 MCP 服务上线。
    • 与客户端交互：在 MCP 客户端中选择对应的服务器后，可按工具名称发起请求（如 google_search、translate、wikipedia 等），服务器按 MCP 协议接收请求并返回结构化结果或错误信息。工具定义覆盖资源读取、网页搜索、文档读取、媒体处理、以及云存储等常见场景，便于 LLM 进行上下文感知与行动执行。
    • 调试与开发：服务器端代码在 src/google_search_mcp/server.py，具备完整的工具注册、请求处理与多种工具实现，开发者可在此文件中扩展或修改工具集合及行为。

服务器信息

访问项目