Mcp Google Server A Mcp Сервер Для Google Пользовательского Поиска И Чтения Веб-страниц

Что такое mcp-google-search?

mcp-google-search — это публичный репозиторий, созданный пользователем ### adenot на GitHub. Этот проект сосредоточен на улучшении возможностей поиска в Google, потенциально предоставляя пользователям улучшенные результаты поиска и функциональные возможности. Он разработан как решение с открытым исходным кодом, позволяя разработчикам вносить свой вклад и улучшать его функции.

Особенности mcp-google-search

• Открытый исходный код: Репозиторий доступен для всех, что позволяет любому просматривать, использовать и вносить изменения в код.
• Улучшенная функциональность поиска: Проект нацелен на улучшение взаимодействия пользователей с поиском Google, потенциально предлагая функции, которые упрощают процесс поиска.
• Сообщество: Как проект с открытым исходным кодом, он поощряет сотрудничество среди разработчиков, способствуя созданию сообщества, которое может способствовать его росту и улучшению.
• Документация: Предоставляется полная документация, чтобы помочь пользователям понять, как эффективно реализовать и использовать функции репозитория.

Как использовать mcp-google-search

1. Клонируйте репозиторий: Начните с клонирования репозитория на ваш локальный компьютер с помощью команды:

   git clone https://github.com/adenot/mcp-google-search.git
   

2. Установите зависимости: Перейдите в каталог проекта и установите необходимые зависимости. Это обычно можно сделать с помощью менеджеров пакетов, таких как npm или yarn, в зависимости от настройки проекта.

3. Запустите приложение: Следуйте инструкциям в документации, чтобы запустить приложение. Это может включать запуск локального сервера или выполнение определенных скриптов.

4. Внесите вклад: Если вы хотите внести свой вклад в проект, ознакомьтесь с руководством по внесению изменений, представленным в репозитории. Вы можете отправлять проблемы, запросы на функции или даже pull-запросы с вашими улучшениями.

Часто задаваемые вопросы

Какие языки программирования используются в mcp-google-search?

Проект в основном использует JavaScript, но также может включать HTML и CSS для разработки интерфейса.

Как я могу сообщить о проблемах или ошибках?

Вы можете сообщить о проблемах, перейдя на вкладку "Issues" в репозитории и отправив новую проблему с подробной информацией о проблеме.

Есть ли лицензия для mcp-google-search?

Да, репозиторий лицензирован под лицензией MIT, которая позволяет свободное использование, модификацию и распространение программного обеспечения.

Как я могу оставаться в курсе изменений в репозитории?

Вы можете следить за репозиторием на GitHub, чтобы получать уведомления об обновлениях, или вы можете следить за проектом в социальных сетях, если это возможно.

Могу ли я внести вклад в проект?

Абсолютно! Внесение вкладов приветствуется. Пожалуйста, обратитесь к руководству по внесению изменений в репозитории для получения дополнительной информации о том, как участвовать.

mcp-google-server A MCP Server for Google Custom Search and Webpage Reading

A Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.

Setup

Getting Google API Key and Search Engine ID

1. Create a Google Cloud Project:

   • Go to Google Cloud Console
   • Create a new project or select an existing one
   • Enable billing for your project

2. Enable Custom Search API:

   • Go to API Library
   • Search for "Custom Search API"
   • Click "Enable"

3. Get API Key:

   • Go to Credentials
   • Click "Create Credentials" > "API Key"
   • Copy your API key
   • (Optional) Restrict the API key to only Custom Search API

4. Create Custom Search Engine:

   • Go to Programmable Search Engine
   • Enter the sites you want to search (use www.google.com for general web search)
   • Click "Create"
   • On the next page, click "Customize"
   • In the settings, enable "Search the entire web"
   • Copy your Search Engine ID (cx)

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Features

Search Tool

Perform web searches using Google Custom Search API:

• Search the entire web or specific sites
• Control number of results (1-10)
• Get structured results with title, link, and snippet

Webpage Reader Tool

Extract content from any webpage:

• Fetch and parse webpage content
• Extract page title and main text
• Clean content by removing scripts and styles
• Return structured data with title, text, and URL

Installation

Installing via Smithery

To install Google Custom Search Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @adenot/mcp-google-search --client claude

To use with Claude Desktop, add the server config with your Google API credentials:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@adenot/mcp-google-search"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-api-key-here",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id-here"
      }
    }
  }
}

Usage

Search Tool

{
  "name": "search",
  "arguments": {
    "query": "your search query",
    "num": 5  // optional, default is 5, max is 10
  }
}

Webpage Reader Tool

{
  "name": "read_webpage",
  "arguments": {
    "url": "https://example.com"
  }
}

Example response from webpage reader:

{
  "title": "Example Domain",
  "text": "Extracted and cleaned webpage content...",
  "url": "https://example.com"
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.