mcpsmith — MCP-сервер для Claude Code: API в инструменты агента
Превращает OpenAPI, Postman, cURL, SQL и сайты с логином в набор инструментов, которые агент проектирует сам. Пригодится, когда нужен MCP-сервер под конкретный API и без написания кода вручную.
claude mcp add mcpsmith -- uvx mcpsmithЧто делает mcpsmith
mcpsmith читает описание сервиса и отдаёт агенту план инструментов. Пользователь запускает toolsmelt inspect <file-or-url>, агент изучает спецификацию, правит plan.yaml, проверяет его и подключает инструменты к сессии. Из плана можно сгенерировать обычный Python-код, которым вы владеете: тогда сервер можно публиковать.
На входе — OpenAPI или Swagger по файлу и ссылке, экспорт коллекции Postman, команды cURL из DevTools, базы через SQLAlchemy (для этого нужен pip install "toolsmelt[sql]"), gRPC через pip install "toolsmelt[grpc]", SOAP с WSDL. Сайты с авторизацией разбираются иначе: toolsmelt browser поднимает общий Chrome на порту 9222, вы логинитесь сами, а агент записывает запросы через smith_record_start и smith_record_stop. Пароли и коды 2FA до агента не доходят.
Ключ API не нужен — дизайнером выступает сам кодинг-агент. Есть готовые скиллы build-mcp-server, extract-api и design-mcp-tools. Ограничение важное: подключения живого хаба персональные, лежат в ~/.toolsmelt, и generate отказывается собирать планы с авторизацией через браузер. Без прокси в переменных окружения MCP-клиента smith_inspect не скачает спецификацию: MCP-серверы стартуют без переменных вашей оболочки.
Какие задачи решает
- собрать MCP-инструменты из OpenAPI-спецификации
- завернуть базу SQLite или PostgreSQL в вызовы для агента
- снять API закрытого дашборда после ручного входа
- разобрать эндпоинты Android-приложения по APK
- подключить инструменты к агенту без публикации сервера
Примеры запросов агенту
- Построй инструменты по спецификации
openapi.yamlи покажи план. - Запиши
example.comв общем Chrome и подключи его как инструменты. - Проверь
plan.yamlи сгенерируй Python-сервер для команды.
Как установить mcpsmith
Командой платформы
claude mcp add mcpsmith -- uvx mcpsmithuvx запускает команду с именем пакета; если в README она другая — uvx --from mcpsmith <команда>
Командой платформы
codex mcp add mcpsmith -- uvx mcpsmithuvx запускает команду с именем пакета; если в README она другая — uvx --from mcpsmith <команда>
Файл настроек
{
"mcpServers": {
"mcpsmith": {
"command": "uvx",
"args": [
"mcpsmith"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcpsmith <команда>
Файл настроек
{
"servers": {
"mcpsmith": {
"type": "stdio",
"command": "uvx",
"args": [
"mcpsmith"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcpsmith <команда>
Командой платформы
gemini mcp add mcpsmith uvx mcpsmithuvx запускает команду с именем пакета; если в README она другая — uvx --from mcpsmith <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcpsmith
Как установить mcpsmith в Claude Code?
Одной командой: claude mcp add mcpsmith -- uvx mcpsmith. Под именем mcpsmith работает и прежнее имя toolsmelt.
Что делает mcpsmith?
Берёт описание API или приложения и превращает его в набор MCP-инструментов. Дизайн предлагает ваш агент, вы проверяете план и подключаете инструменты.
Нужен ли ключ API для работы?
Нет, агенту-дизайнеру ключ не требуется. Зато за прокси без HTTPS_PROXY в env MCP-клиента smith_inspect не сможет скачать спецификацию.
