Skip to content

Latest commit

 

History

History
161 lines (108 loc) · 10.5 KB

README.md

File metadata and controls

161 lines (108 loc) · 10.5 KB

Тестування та налагодження

Перед тим, як почати тестувати свій MCP сервер, важливо розуміти доступні інструменти та найкращі практики налагодження. Ефективне тестування гарантує, що ваш сервер працює відповідно до очікувань, і допомагає швидко виявляти та усувати проблеми. У наступному розділі описані рекомендовані підходи для перевірки вашої реалізації MCP.

Огляд

У цьому уроці розглядається, як обрати правильний підхід до тестування та найефективніший інструмент для цього.

Цілі навчання

Після завершення уроку ви зможете:

  • Описувати різні підходи до тестування.
  • Використовувати різні інструменти для ефективного тестування коду.

Тестування MCP серверів

MCP надає інструменти, які допоможуть вам тестувати та налагоджувати сервери:

  • MCP Inspector: інструмент командного рядка, який можна запускати як у CLI-режимі, так і у візуальному режимі.
  • Ручне тестування: можна використовувати інструменти на кшталт curl для виконання веб-запитів, але підійде будь-який інструмент, що підтримує HTTP.
  • Модульне тестування: можна застосовувати улюблені фреймворки для тестування функціоналу як сервера, так і клієнта.

Використання MCP Inspector

Ми вже описували використання цього інструменту в попередніх уроках, але давайте коротко згадаємо. Це інструмент, створений на Node.js, який можна запускати через виконуваний файл npx. Він тимчасово завантажує та встановлює інструмент, а після завершення роботи очищає себе.

MCP Inspector допомагає вам:

  • Виявляти можливості сервера: автоматично знаходить доступні ресурси, інструменти та підказки
  • Тестувати виконання інструментів: пробувати різні параметри та бачити відповіді в реальному часі
  • Переглядати метадані сервера: досліджувати інформацію про сервер, схеми та конфігурації

Типовий запуск інструменту виглядає так:

npx @modelcontextprotocol/inspector node build/index.js

Вказана команда запускає MCP та його візуальний інтерфейс, відкриваючи локальний веб-інтерфейс у вашому браузері. Ви побачите панель керування з переліком зареєстрованих MCP серверів, їх доступних інструментів, ресурсів та підказок. Інтерфейс дозволяє інтерактивно тестувати виконання інструментів, переглядати метадані сервера та отримувати відповіді в реальному часі, що значно полегшує перевірку та налагодження реалізацій MCP серверів.

Ось як це може виглядати: Inspector

Також цей інструмент можна запускати в CLI-режимі, додавши атрибут --cli. Ось приклад запуску в режимі "CLI", який виводить список усіх інструментів на сервері:

npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list

Ручне тестування

Окрім запуску інструменту inspector для перевірки можливостей сервера, можна використовувати клієнт, здатний виконувати HTTP-запити, наприклад curl.

За допомогою curl ви можете тестувати MCP сервери безпосередньо через HTTP-запити:

# Example: Test server metadata
curl http://localhost:3000/v1/metadata

# Example: Execute a tool
curl -X POST http://localhost:3000/v1/tools/execute \
  -H "Content-Type: application/json" \
  -d '{"name": "calculator", "parameters": {"expression": "2+2"}}'

Як видно з прикладу використання curl, ви надсилаєте POST-запит для виклику інструменту з навантаженням, що містить ім’я інструменту та його параметри. Обирайте підхід, який вам зручніший. CLI-інструменти зазвичай швидші у використанні і добре підходять для автоматизації, що корисно в CI/CD середовищах.

Модульне тестування

Створюйте модульні тести для своїх інструментів і ресурсів, щоб переконатися, що вони працюють як слід. Ось приклад коду для тестування.

import pytest

from mcp.server.fastmcp import FastMCP
from mcp.shared.memory import (
    create_connected_server_and_client_session as create_session,
)

# Mark the whole module for async tests
pytestmark = pytest.mark.anyio


async def test_list_tools_cursor_parameter():
    """Test that the cursor parameter is accepted for list_tools.

    Note: FastMCP doesn't currently implement pagination, so this test
    only verifies that the cursor parameter is accepted by the client.
    """

 server = FastMCP("test")

    # Create a couple of test tools
    @server.tool(name="test_tool_1")
    async def test_tool_1() -> str:
        """First test tool"""
        return "Result 1"

    @server.tool(name="test_tool_2")
    async def test_tool_2() -> str:
        """Second test tool"""
        return "Result 2"

    async with create_session(server._mcp_server) as client_session:
        # Test without cursor parameter (omitted)
        result1 = await client_session.list_tools()
        assert len(result1.tools) == 2

        # Test with cursor=None
        result2 = await client_session.list_tools(cursor=None)
        assert len(result2.tools) == 2

        # Test with cursor as string
        result3 = await client_session.list_tools(cursor="some_cursor_value")
        assert len(result3.tools) == 2

        # Test with empty string cursor
        result4 = await client_session.list_tools(cursor="")
        assert len(result4.tools) == 2

Наведенний код робить наступне:

  • Використовує фреймворк pytest, який дозволяє створювати тести у вигляді функцій і використовувати assert для перевірок.
  • Створює MCP сервер з двома різними інструментами.
  • Використовує оператор assert для перевірки виконання певних умов.

Перегляньте повний файл тут

Використовуючи цей файл, ви можете протестувати власний сервер, щоб переконатися, що можливості створені правильно.

Усі основні SDK мають подібні розділи для тестування, тож ви можете адаптувати їх під обране середовище виконання.

Приклади

Додаткові ресурси

Що далі

Відмова від відповідальності:
Цей документ було перекладено за допомогою сервісу автоматичного перекладу Co-op Translator. Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для критично важливої інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникли внаслідок використання цього перекладу.