Два MCP-сервера для одной задачи: сравните входные параметры
Как сопоставить имеющийся ввод с inputSchema двух инструментов и не принять совместимые типы за одинаковые данные, права или результат.
Начните с данных, которые уже есть
Два сервера могут обещать поиск записи, но принимать разные входы. До подключения выпишите, что вы действительно можете передать: идентификатор из известного пространства, название или иной документированный параметр. Это помогает отсеять неподходящий инструмент без пробных запросов к рабочему источнику.
Откройте описание конкретного инструмента
В описании tools MCP есть имя и inputSchema — схема входных аргументов. Сравнивайте именно нужный инструмент, а не только название сервера. Ниже использована форма описания из MCP 2025-11-25; это учебные объекты, не список функций каталога и не универсальное описание всех версий протокола.
[
{
"name": "demo_lookup_by_id",
"description": "Synthetic lookup by a documented record identifier",
"inputSchema": {
"type": "object",
"properties": {
"record_id": {
"type": "string",
"minLength": 1
}
},
"required": [
"record_id"
],
"additionalProperties": false
}
},
{
"name": "demo_find_by_name",
"description": "Synthetic name search returning candidates",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 5
}
},
"required": [
"query"
],
"additionalProperties": false
}
}
]Разделите поиск по имени и обращение по идентификатору
Первый учебный инструмент требует строковый record_id. Второй требует query и допускает ограничение числа кандидатов limit. Наличие названия компании ещё не даёт record_id: нельзя просто переименовать query в record_id и считать ввод эквивалентным.
Даже подходящий по типу идентификатор нуждается в определении: какой источник его присвоил, к какому объекту он относится и какой формат ожидает сервер. Слово string в схеме не устанавливает пространство идентификаторов. Описание параметра и документация источника остаются частью сравнения.
Проверьте обязательность и ограничения
required задаёт необходимые свойства. Список properties описывает допустимые для них значения; сам по себе он не делает каждое поле обязательным. В учебных схемах additionalProperties: false также запрещает посторонние свойства. Не переносите эту настройку на другой инструмент без чтения его схемы.
Пример {"record_id":"DEMO-001"} подходит первой схеме. Пример {"query":"Учебное название","limit":2} — второй. Это локальная проверка структуры, а не выполненный поиск и не доказательство существования записи. Число 5 — выбранный предел учебного параметра, не лимит продукта.
- Передайте объект с query в первую схему: он не соответствует требуемому record_id.
- Передайте limit строкой вместо целого числа во вторую схему: тип не подходит.
- Уберите query из второго объекта: необязательность limit не делает весь ввод необязательным.
Сравните смысл выхода отдельно
Совместимый вход не означает одинаковый результат. Уточните, возвращает ли операция одну запись, несколько кандидатов или только ссылку на источник. Для списка кандидатов нужно отдельное правило выбора; имя инструмента само по себе такого правила не задаёт.
Не выводите права доступа, охват данных или последствия действия из названия. Полезно отдельно записать требуемые разрешения и то, меняет ли операция данные. Схема входа не является подтверждением, что выбранное действие можно выполнить в вашем окружении.
Сохраните короткую таблицу решения
Для каждого кандидата оставьте четыре заметки: имеющийся ввод; требуемый ввод и его смысл; ожидаемый результат; неподтверждённые условия. Если важный параметр неизвестен, сохраните вопрос, а не выдумывайте значение.
После такого сравнения откройте каталог MCP-серверов по ссылке ниже и документацию выбранного проекта. Первый разрешённый запрос проверяет уже конкретный инструмент и источник; соответствие учебной схеме не заменяет этот этап.
Вопросы по этой странице
Одинаковое имя инструмента означает одинаковый контракт?
Нет. Сравнивайте inputSchema и описание операции каждого сервера. Совпадение имени не устанавливает одинаковые аргументы, источники или результат.
Почему свойства из properties не всегда обязательны?
Обязательность задаётся required. В учебном поиске limit описан в properties, но не включён в required; query включён и должен присутствовать.
Можно ли передать название в поле идентификатора?
Только если это прямо предусмотрено контрактом. В примере имя для поиска и record_id имеют разное назначение; одинаковый строковый тип не делает их взаимозаменяемыми.
Что означает дополнительное поле, которого нет в схеме?
Нужно читать политику дополнительных свойств. В этих двух примерах additionalProperties: false его запрещает. Это не правило всех MCP-инструментов.
Успешная локальная валидация означает, что сервер выполнит запрос?
Нет. Она проверяет выбранные структурные ограничения. Доступ, бизнес-правила, наличие записи и работоспособность источника проверяются отдельно.
Может ли поиск по названию вернуть несколько подходящих записей?
Это нужно выяснить по описанию результата. Учебный второй инструмент обозначен как поиск кандидатов; схема входа не выбирает правильную запись за пользователя.
Что делать, если смысл record_id не описан?
Сохраните неизвестность и уточните источник, тип объекта и формат идентификатора у автора. Не подставляйте похожий номер только ради соответствия типу string.