MCP server tinymcp
✓ ОфициальныйПозволяет LLM управлять встраиваемыми устройствами, предоставляя Golioth RPC и LightDB State в качестве инструментов MCP.
Также известен как golioth/tinymcp
- Звёзды
- 158
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 3 июл. 2025 г.
- Лицензия
- Apache-2.0
Что такое tinymcp MCP?
Позволяет LLM управлять встраиваемыми устройствами, предоставляя Golioth RPC и LightDB State в качестве инструментов MCP.
Сводка сгенерирована из README проекта
О tinymcp MCP server
tinymcp позволяет управлять встраиваемыми устройствами через LLM, превращая Golioth RPC и LightDB State в доступные инструменты MCP. Разработчики, запускающие tinymcp локально, могут подключаться к удаленному оборудованию через Golioth management API. Указывая переменные окружения TINYMCP_PROJECT, TINYMCP_DEVICE и TINYMCP_API_KEY, пользователи связывают свою локальную среду с конкретными проектами и устройствами Golioth.
Особенность этой настройки заключается в том, что она позволяет открывать существующие функции устройств без необходимости изменения прошивки. Это достигается путем включения схемы по пути mcp/tools/schema внутри LightDB State. Хотя проект включает пример с миганием светодиода (blinky) на базе Zephyr RTOS для тех, кто начинает с нуля, сервер разработан для работы с устройствами, уже подключенными к платформе Golioth. Совместимые клиенты, такие как Claude Code, Gemini CLI и MCP Inspector, могут взаимодействовать с этими физическими возможностями через стандартные вызовы инструментов.
Что вы можете с ним делать
- 1Управление оборудованием без обновления прошивкиРазработчик может дать ИИ команду запустить функцию устройства, обновив схему LightDB State.
- 2Визуальная проверка взаимодействия с устройствомИспользуйте MCP Inspector, чтобы убедиться, что конкретные RPC правильно представлены в качестве инструментов перед использованием LLM.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Конфигурация
TINYMCP_API_KEYTINYMCP_DEVICETINYMCP_PROJECT
| Название | Описание | Тип |
|---|---|---|
| TINYMCP_API_KEY | — | |
| TINYMCP_DEVICE | — | |
| TINYMCP_PROJECT | — |
Автоматические проверки
Запущено 15 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийgolioth/tinymcp is public and reachablegithub.com/golioth/tinymcp ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2025-07-03github.com/golioth/tinymcp ↗Проблема
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubtinymcp
Let LLMs control embedded devices via the Model Context Protocol.
[!WARNING]
tinymcpis an experimental project. Expect frequent breaking changes. Extreme caution should be taken when delegating physical capabilities to AI systems.
Background
The tinymcp project includes an MCP server, which is executed locally, but
communicates with remote devices via the Golioth management
API. It uses two existing
device services on the Golioth platform, LightDB
State and Remote
Procedure Calls (RPCs), to
expose device functionality via MCP.
RPCs can be exposed as
tools
by including a schema in on the mcp/tools/schema path in LightDB State.
Because LightDB State can be updated by devices or users, RPCs on existing
devices can be exposed without needing to modify the device firmware.
Setup
To use tinymcp, you need to connect a device to the Golioth platform, then run
the tinymcp server on your local machine.
Firmware
While existing devices can be used without changing the firmware, if you don't
already have a device on Golioth, the blinky example
provides a simple demonstration of how to expose LED control to an LLM via
tinymcp. It uses Zephyr RTOS, which requires
setting up
dependencies
before building. After doing so, you can initialize your workspace with one of
the following commands.
west init -l .
Or, to use the downstream Nordic nRF Connect SDK.
west init -l . --mf west-ncs.yml
With your workspace initialized, use west update to fetch necessary modules
and libraries.
west update --narrow -o=--depth=1
You are now ready to build the firmware and flash your device. See the blinky documentation for more information.
Server
In order to run the tinymcp MCP server locally, the following environment
variables need to be supplied.
TINYMCP_PROJECT=<your-golioth-project-id>
TINYMCP_DEVICE=<your-golioth-device-id>
TINYMCP_API_KEY=<api-key-for-your-golioth-project>
The server can be built into an executable using go build -o tinymcp ./server
or run directly with go run ./server.
If you don't already have a device on Golioth, the blinky
example demonstrates how to expose LED control to an LLM via
tinymcp. See the documentation to build and
flash on your device, then expose the registered RPCs in your MCP schema.
There are many MCP client
implementations, most of which should
be compatible with tinymcp. Setup for a few popular options are listed below.
MCP Inspector
MCP Inspector is a visual testing tool for MCP servers. It allows you to interact with MCP methods directly, rather than going through an LLM. This can be useful when troubleshooting why an LLM may be failing to interact with your device.
The
documentation
provides information on how to quickly start the inspector. Once it is running,
you can point it to your local tinymcp MCP server by entering
http://localhost:8080 as the address and clicking Connect. You should be
presented with an option to List Tools, which should result in all of the RPCs
in your schema being exposed.
Claude Code
Claude Code is an agentic coding tool that you interact with in the terminal.
With the tinymcp MCP server running locally, it can be added to Claude
Code with a single command.
claude mcp add --transport http tinymcp http://localhost:8080 -H 'Authorization: Bearer none'
[!NOTE] The
Authorizationheader is supplied in this case to indicate to Claude Code that it should not attempt to authenticate via the OAuth flow.
Gemini CLI
The Gemini CLI is an open-source AI agent that allows you to access Gemini from the terminal.
The .gemini/settings.json file in this repository
will automatically configure the CLI to connect to a locally running tinymcp
MCP server if the CLI is started in this repository.
Вопросы о tinymcp MCP
Нужно ли изменять прошивку устройства для использования tinymcp?
Нет, существующие устройства на платформе Golioth можно использовать без изменений прошивки, предоставляя RPC через схему LightDB State.
Какие переменные окружения необходимы для запуска сервера?
Вам необходимо указать ID проекта Golioth, ID устройства и API key вашего проекта Golioth.
Можно ли использовать это с Claude Code?
Да, вы можете добавить запущенный сервер tinymcp в Claude Code одной командой через HTTP transport.