# Onesdk

> OneSDK: A unified AI access SDK for edge devices, providing LLM capabilities (text/voice chat, image generation) and IoT device management with MQTT support, compatible with ESP32, Linux, macOS, and Windows platforms.

- **Type:** MCP server
- **Install:** `agentstack add mcp-volcengine-onesdk`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [volcengine](https://agentstack.voostack.com/s/volcengine)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [volcengine](https://github.com/volcengine)
- **Source:** https://github.com/volcengine/onesdk

## Install

```sh
agentstack add mcp-volcengine-onesdk
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

English | [中文README](README.zh_CN.md)

OneSDK: A Unified AI Access SDK for the Client-side

## Table of Contents

- [Table of Contents](#table-of-contents)
- [Introduction](#introduction)
- [Features](#features)
  - [Overall Architecture](#overall-architecture)
  - [Feature List](#feature-list)
- [Quick Start](#quick-start)
  - [Prerequisites](#prerequisites)
  - [Installation, Compilation, and Execution](#installation-compilation-and-execution)
- [Contribution](#contribution)
- [Code of Conduct](#code-of-conduct)
- [Security](#security)
- [License](#license)

## Introduction

OneSDK is an integrated development kit for AI applications on the client-side. It provides large language model (LLM) capabilities including voice conversations, text chats, and agents. It also offers device management, supporting interaction with IoT platforms via the MQTT protocol. The SDK is based on libwebsockets to implement protocols like HTTP, WebSocket, and MQTT. It runs on embedded platforms such as Espressif ESP32, FreeRTOS, and uc-OS2, as well as general-purpose platforms like Linux, macOS, and Windows.

## Features

### Overall Architecture

### Feature List
- **Device Intelligence**
  - **Text Chat**: Supports large model text chat (both streaming and non-streaming).
  - **Image Generation**: Supports large model image recognition and text-to-image generation.
  - **Voice Chat Agent**: Supports various voice chat agents, integrated with Realtime (WebSocket) API.
- **Device Operations**
  - **OTA Upgrade Support**
    - Full package upgrade
    - Differential package upgrade
  - **Device Management**
    - **Token Quota**: Check current quota usage from the cloud console.
  - **SSH**: Supports SSH connections from the console.
  - **Logging**: Supports uploading device operation logs.
- **Device Security**
  - Supports device-side identity authentication with "one key per device" and "one key per product type".
  - Supports device certificates.

## Quick Start

### Prerequisites

**CMake Version Requirement:**
- **Minimum**: CMake 3.10
- **Recommended**: CMake 3.26.x
- **Incompatible**: CMake 4.x (may cause cJSON compatibility issues)

For detailed CMake installation instructions, see [CMake Version Requirements](docs/cmake_version_requirements.md).

Supported Platforms:
- Espressif ESP32
- RTOS (FreeRTOS/uc-OS2)
- Linux (amd64/arm64)
- macOS (Apple Silicon/Intel)
- Windows (x64/x86)

### Installation, Compilation, and Execution

#### Linux/macOS
Refer to the [Development Guide](docs/develop.md) for instructions on building, compiling, and running.

#### Windows
Refer to the [Windows Development Guide](docs/develop_windows.md) for detailed Windows-specific setup and build instructions.

**Quick Windows Build:**
```cmd
# Clone the repository
git clone --recursive https://github.com/volcengine/onesdk.git
cd onesdk

# Build using Visual Studio (recommended)
build.bat
# or 
build.ps1

# Or build using MinGW-w64
mkdir build
cd build
cmake -G "MinGW Makefiles" ..
mingw32-make
```

## Contribution

Please check [Contributing](CONTRIBUTING.md) for more details.

## Code of Conduct

Please check [Code of Conduct](CODE_OF_CONDUCT.md) for more details.

## Security

If you discover a potential security issue in this project, or think you may
have discovered a security issue, we ask that you notify Bytedance Security via our [security center](https://security.bytedance.com/src) or [vulnerability reporting email](sec@bytedance.com).

Please do **not** create a public GitHub issue.

## License

This project is licensed under the [Apache-2.0 License](LICENSE.txt).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [volcengine](https://github.com/volcengine)
- **Source:** [volcengine/onesdk](https://github.com/volcengine/onesdk)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-volcengine-onesdk
- Seller: https://agentstack.voostack.com/s/volcengine
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.