docs: publish translated docs in twelve languages and the tool that maintains them (#3280)
This commit is contained in:
parent
14aa889992
commit
52ad0a8876
1 changed files with 89737 additions and 54 deletions
56
i18n/ru/pages/get-started/index.md
Normal file
56
i18n/ru/pages/get-started/index.md
Normal file
|
|
@ -0,0 +1,56 @@
|
|||
---
|
||||
translation:
|
||||
sections: [ed4a756b4c53c585, 97e2fb315b7fe398, 4d04f1c6f4bf6c1d, 577d73078fc62baf]
|
||||
tool: 1
|
||||
---
|
||||
# Начало работы {#get-started}
|
||||
|
||||
Впервые работаете с MCP или с этим SDK? Начните здесь. Эти страницы проведут вас от нуля до работающего, протестированного сервера: [установите SDK](installation.md), соберите
|
||||
[первый сервер](first-steps.md), [подключите его к настоящему хосту](real-host.md) и
|
||||
[протестируйте](testing.md) с помощью клиента в памяти.
|
||||
|
||||
## Запуск кода {#run-the-code}
|
||||
|
||||
Все блоки кода можно копировать и использовать как есть: это полные, рабочие файлы.
|
||||
|
||||
Чтобы повторять шаги по ходу чтения, вставьте блок в файл `server.py` и откройте его в MCP Inspector:
|
||||
|
||||
```console
|
||||
uv run mcp dev server.py
|
||||
```
|
||||
|
||||
**Настоятельно рекомендуем** писать (или копировать) код, править его и запускать локально. Именно работа в собственном редакторе показывает суть: как мало приходится писать, как помогает автодополнение, как проверка типов ловит ошибки ещё до запуска.
|
||||
|
||||
## Гадать не придётся {#you-will-not-be-guessing}
|
||||
|
||||
Каждый пример в этой документации — полный файл в каталоге [`docs_src/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/docs_src) в репозитории самого SDK, и каждый из них прогоняется набором тестов SDK через **клиент в памяти**:
|
||||
|
||||
```python
|
||||
import pytest
|
||||
from mcp import Client
|
||||
|
||||
from server import mcp
|
||||
|
||||
|
||||
@pytest.mark.anyio
|
||||
async def test_add() -> None:
|
||||
async with Client(mcp) as client:
|
||||
result = await client.call_tool("add", {"a": 1, "b": 2})
|
||||
assert result.structured_content == {"result": 3}
|
||||
```
|
||||
|
||||
Ни подпроцесса, ни порта, ни транспорта. `Client(mcp)` подключается к объекту сервера напрямую.
|
||||
|
||||
Если изменение в SDK ломает пример на одной из этих страниц, CI краснеет раньше, чем страница. Код, который вы здесь читаете, — это код, который выполняется.
|
||||
|
||||
Вы и сами воспользуетесь этим приёмом на странице [Тестирование](testing.md): свои серверы тестируют точно так же.
|
||||
|
||||
## Куда дальше {#where-to-go-next}
|
||||
|
||||
Как только сервер запущен, остальная документация — это справочник, а не курс.
|
||||
Каждая страница самодостаточна, так что переходите сразу к нужному:
|
||||
|
||||
* Что сервер предоставляет (инструменты, ресурсы, промпты) — **[Серверы](../servers/index.md)**.
|
||||
* Что доступно внутри регистрируемых функций — **[Внутри обработчика](../handlers/index.md)**.
|
||||
* Как донести сервер до клиентов (stdio, HTTP, существующее FastAPI-приложение) — **[Запуск сервера](../run/index.md)**.
|
||||
* Как построить другую сторону — приложение, которое *использует* MCP-серверы, — **[Клиенты](../client/index.md)**.
|
||||
Loading…
Reference in a new issue