Створення та розгортання легковагого Model Context Protocol сервера на Edge Compute
Розгорніть сервер протоколу контексту моделей (MCP) на 167 рядків коду Python на Telnyx Edge Compute, використовуючи лише стандартну бібліотеку. Сервер надає API Telnyx як нативні інструменти для Claude та Cursor без холодних стартів.
Вплив: Середній
Чому це важливо
Це готовий шаблон для створення високопродуктивних MCP-серверів з низькою затримкою без важких фреймворків на кшталт FastAPI чи Express.
TL;DR
- 01Пошук та виклик інструментів MCP є простими контрактами HTTP, що реалізуються засобами стандартної бібліотеки.
- 02Розміщення хостингу інструментів ближче до цільових API суттєво зменшує затримку мережевих запитів.
- 03Використання ASGI безпосередньо усуває потребу у важких зовнішніх пакетах і зменшує час холодного старту.
Ключові факти
- Обсяг коду
- 167 рядків Python
- Залежності
- Лише стандартна бібліотека (0 зовнішніх пакетів)
- Доступні інструменти MCP
- 4 (SMS, пошук номерів, генерація, список номерів)
Реалізація MCP на базі ASGI
Замість важких фреймворків ця реалізація використовує мінімалістичний ASGI-обробник handle(scope, receive, send), який безпосередньо перехоплює HTTP-запити. Контракт вимагає обробки двох основних дій MCP:
tools/list: Повертає масив JSON із визначеннями інструментів (імена, описи та схеми вхідних даних).tools/call: Виконує інструмент, що відповідає запитаному імені, приймаючи аргументи у пласкому або вкладеному форматі.
Архітектура без залежностей
Бекенд-код працює взагалі без зовнішніх залежностей, використовуючи лише стандартну бібліотеку Python. Основна робота покладається на urllib.request для зв'язку з REST API та json для серіалізації відповідей. Змінні оточення безпечно передають секрети на кшталт TELNYX_API_KEY під час запуску, приховуючи їх від агентів.
Кроки для розгортання
Щоб протестувати конфігурацію локально або розгорнути її на Telnyx Edge Compute, клонуйте репозиторій та налаштуйте секрети:
git clone https://github.com/team-telnyx/telnyx-code-examples.git
cd telnyx-code-examples/edge-mcp-server-deploy-python
telnyx-edge secrets add TELNYX_API_KEY <ваш_ключ>Спробуй за 2 хвилини
async def handle(self, scope, receive, send):
path = scope.get("path", "")
method = scope.get("method", "")
if path == "/mcp/tools/list" and method in ("GET", "POST"):
await self._respond(send, 200, {"tools": TOOLS})python
✓ Коли використовувати
- Для розгортання інструментів ШІ-агентів з низькою затримкою, які мають працювати поруч із телеком- або іншою інфраструктурою.
- Коли ви хочете уникнути оверхеду контейнерів та холодного старту за допомогою безсерверних edge-середовищ.
- При створенні легких MCP-конекторів без важкого сліду FastAPI чи Express.
✕ Коли НЕ варто
- Якщо вашим інструментам потрібні складні процеси авторизації OAuth або сторонні SDK, які важко запакувати.
- Якщо у вашому середовищі немає вебсервера або раннера, сумісного з ASGI.
Що зробити сьогодні
- Клонуйте репозиторій Telnyx MCP на Python.
- Розгорніть безсерверний код за допомогою інструменту telnyx-edge CLI.
- Вкажіть URL розгорнутого edge-сервера в конфігурації MCP для Claude Code або Cursor.
Джерела