liaokongvfx/mcp-chinese-getting-started-guide

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

3,6 тыс. stars 234 forks Качество 66 Тренд 27

Repository Install

Протокол контекста модели (MCP) — программирование быстрого запуска

Обзор

Протокол контекста модели (MCP) — это инновационный протокол с открытым исходным кодом, который переопределяет, как большие языковые модели (LLM) взаимодействуют с внешним миром. MCP предлагает стандартизированный подход, позволяющий любой крупной языковой модели легко подключаться к различным источникам данных и инструментам, обеспечивая беспрепятственный доступ и обработку информации. MCP действует как интерфейс USB-C для приложений на базе ИИ, предоставляя моделям ИИ стандартизированный способ соединения различных источников данных и инструментов. - Ресурсы - Подсказки - Инструменты - Выборка - Корни - Транспортный уровень транспорта Поскольку большинство функций действительно обслуживают клиент Claude, в этой статье рассматривается написание серверных сервисов MCP и общих крупных языковых моделей, поэтому в статье будет сосредоточено в основном на «инструментах», а другие функции будут кратко объяснены в конце. Среди них транспортный слой MCP поддерживает два протокола: stdio (стандартный ввод/вывод) и SSE (сервер отправляет события). Поскольку stdio используется чаще, в этой статье будет использован stdio в качестве примера для объяснения. В этой статье будет использована версия Python версии 3.11 и управление проектами на Python с помощью UV. В конце статьи код будет опубликован на GitHub. Без лишних слов, давайте начнём~ В этом разделе мы реализуем сервер для веб-поиска. Сначала мы инициализируем наш проект с помощью UV. Далее создадим файл под названием web_search.py для реализации наших сервисов. MCP предоставляет нам два объекта: mcp.server.FastMCP и mcp.server.Server. mcp.server.FastMCP — это инкапсуляция более высокого уровня, и мы используем её здесь. Реализация очень простая. MCP предоставляет нам @mcp.tool(). Нужно просто украсить функцию реализации этим декоратором. Имя функции будет имя инструмента, параметр — параметром инструмента, а инструмент, параметры и возвращаемые значения будут описаны комментариями.

Обзор (машинный перевод)

[TOC]

Введение

MCP выполняет следующие основные функции:

Ресурсы
Подсказки: слова для подсказок
Инструменты
Дискретизация
Корни
Слой транспортов

Поскольку большинство функций действительно обслуживают клиент Claude, в этой статье рассматривается написание серверных сервисов MCP и общих крупных языковых моделей, поэтому в статье будет сосредоточено в основном на «инструментах», а другие функции будут кратко объяснены в конце.

Среди них транспортный слой MCP поддерживает два протокола: stdio (стандартный ввод/вывод) и SSE (сервер отправляет события). Поскольку stdio используется чаще, в этой статье будет использован stdio в качестве примера для объяснения.

В этой статье будет использована версия Python версии 3.11 и управление проектами на Python с помощью UV. В конце статьи код будет опубликован на GitHub. Без лишних слов, давайте начнём~

Разработка MCP-серверов

В этом разделе мы реализуем сервер для веб-поиска. Сначала мы инициализируем наш проект с помощью UV.

Официальная документация UV: https://docs.astral.sh/uv/

Далее создадим файл под названием web_search.py для реализации нашего сервиса. MCP предоставляет нам два объекта: mcp.server.FastMCP и mcp.server.Server. mcp.server.FastMCP — это пакет более высокого уровня, который мы используем здесь.

Метод реализации очень прост. MCP предоставляет нам @mcp.tool(), который нужно просто украсить функцию реализации этим декоратором. Имя функции будет именем инструмента, параметром — параметром инструмента, а инструмент и параметры будут описаны комментариями, а также возвращаемыми значениями.

Здесь мы напрямую используем интерфейс Zhipu. Этот интерфейс не только помогает нам искать связанные ссылки на результаты, но и генерирует сводки статей по этим ссылкам, ~~, и сейчас он бесплатный~~ (уже началась плата, 0,03 юаня за запись), что очень подходит нам.

официальная документация: https://bigmodel.cn/dev/api/search-tool/web-search-pro

Адрес генерации ключа API: https://bigmodel.cn/usercenter/proj-mgmt/apikeys

Наконец, добавим код для запуска сервера.

Отладка сервера MCP

На этом этапе мы заканчиваем написание сервера MCP.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

Установка

npx -y @modelcontextprotocol/inspector <command> <arg1> <arg2>

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "web-search-server": {
      "command": "uv",
      "args": [
        "--directory",
        "D:/projects/mcp_getting_started",
        "run",
        "web_search.py"
      ]
    }
  }
}