Metadata-Version: 2.4
Name: google-search-mcp
Version: 0.1.1
Summary: Google Search MCP Server - A Python implementation using FastMCP for Google Custom Search API integration
Author: Google Search MCP
Maintainer: Google Search MCP
License: MIT
License-File: LICENSE
Keywords: api,fastmcp,google-search,mcp,search
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: fastmcp>=2.11.3
Requires-Dist: httpx[socks]>=0.25.0
Requires-Dist: lxml>=4.9.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: flake8>=6.0.0; extra == 'dev'
Requires-Dist: isort>=5.12.0; extra == 'dev'
Requires-Dist: mypy>=1.5.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Google Search MCP Service

这是一个MCP（模型上下文协议）服务，提供对 Google Custom Search API 的访问。它允许您与 Google 搜索进行交互，并检索网页内容和搜索结果。

## 功能

- 搜索
    - google_search 执行 Google 搜索
    - read_webpage 提取网页内容

- 搜索功能
    - 自定义搜索结果数量
    - 支持多种搜索参数
    - 返回标题、链接、摘要等信息

- 网页内容提取
    - 提取网页文本内容
    - 清理HTML标签
    - 获取页面元数据
    - 支持多种内容格式

- 网络支持
    - HTTP 代理支持
    - SOCKS 代理支持
    - 自定义请求头
    - 超时控制

## 安装

```bash
# 克隆仓库
git clone https://github.com/your-repo/google-search-mcp.git
cd google-search-mcp

# 创建并激活虚拟环境
uv sync
```

## 使用（如Claude客户端）

URL: https://mcpcn.com/docs/quickstart/user/

claude_desktop_config.json
```json
{
    "mcpServers": {
        "google-search": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/Desktop/google-search-mcp", # 替换为你的目录
                "run",
                "google-search-mcp"
            ],
            "env": {
                "GOOGLE_API_KEY": "your_api_key_here", # 替换为你的 Google API 密钥
                "GOOGLE_SEARCH_ENGINE_ID": "your_engine_id_here" # 替换为你的搜索引擎ID
            }
        }
    }
}
```
or

```json
{
    "mcpServers": {
        "google-search": {
            "command": "uvx",
            "args": [
                "google-search-mcp"
            ],
            "env": {
                "GOOGLE_API_KEY": "your_api_key_here", # 替换为你的 Google API 密钥
                "GOOGLE_SEARCH_ENGINE_ID": "your_engine_id_here" # 替换为你的搜索引擎ID
            }
        }
    }
}
```
