stm32

STM32 MCP Documentation Server

An MCP (Model Context Protocol) server that provides semantic search over STM32 microcontroller documentation for use with Claude Code and other AI assistants. Features intelligent document chunking, ChromaDB vector storage, and 16 specialized agents for different embedded development domains.

Features

• One-Command Install: Install as a Claude Code plugin with one command
• Auto-Setup: MCP server, agents, and commands auto-configured on install
• Semantic Search: Find relevant documentation using natural language queries
• Peripheral-Specific Search: Filter results by STM32 peripheral (GPIO, UART, SPI, etc.)
• Code Examples: Retrieve working code examples for any topic
• HAL Function Lookup: Get documentation for specific STM32 HAL/LL library functions
• 16 Specialized Agents: Domain-specific agents for firmware, debugging, power, security, and more
• 4 Slash Commands: Quick access via /stm32, /stm32-hal, /stm32-init, /stm32-debug
• No Hardcoded Paths: Fully portable installation

Quick Start

Plugin Installation (Recommended)

# Install the STM32 plugin
/plugin install github:creativec09/stm32

This single command installs:

• MCP Server: Auto-configured via mcp-config.json
• 16 Agents: Available immediately for specialized STM32 assistance
• 4 Slash Commands: /stm32, /stm32-hal, /stm32-init, /stm32-debug

Alternative: Manual MCP Installation

If you prefer not to use the plugin system, you can install just the MCP server.

Ubuntu 24 / WSL / Linux (auto-installs uv if needed):

claude mcp add-json stm32-docs --scope user '{"command":"bash","args":["-c","export PATH=\"$HOME/.local/bin:$PATH\" && (command -v uvx >/dev/null 2>&1 || curl -LsSf https://astral.sh/uv/install.sh | sh -s -- -q) && uvx --from git+https://github.com/creativec09/stm32.git stm32-mcp-docs"]}'

If you already have uv installed:

claude mcp add stm32-docs --scope user -- uvx --from git+https://github.com/creativec09/stm32.git stm32-mcp-docs

Note: For private repositories, include a GitHub Personal Access Token with repo scope in the URL: git+https://TOKEN@github.com/...

Start Using

After installation, restart Claude Code and use slash commands:

/stm32 How do I configure UART with DMA?
/stm32-init SPI master mode at 10MHz
/stm32-hal HAL_GPIO_Init parameters
/stm32-debug UART not receiving data

Or ask naturally:

"Show me how to configure GPIO interrupts on STM32H7"
"Why is my I2C peripheral returning HAL_TIMEOUT?"

Table of Contents

• Quick Start
• Installation
• MCP Tools
• Specialized Agents
• Usage
• Configuration
• Development
• Troubleshooting
• Uninstall
• License

Installation

Prerequisites

• Python 3.11 or higher (pre-installed on Ubuntu 24)
• curl (pre-installed on Ubuntu 24)
• Claude Code CLI

Note: uv is automatically installed on first use if not present.

Method 1: Plugin Installation (Recommended)

/plugin install github:creativec09/stm32

This installs everything automatically:

• MCP server configuration
• 16 specialized agents
• 4 slash commands

Method 2: Manual MCP + pip Installation

# Install the package
pip install git+https://github.com/creativec09/stm32.git

# Register with Claude Code
claude mcp add stm32-docs --scope user -- python -m mcp_server

Method 3: Development Installation

# Clone the repository
git clone https://github.com/creativec09/stm32.git
cd stm32-agents

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate   # Windows

# Install in development mode
pip install -e ".[dev]"

# Register with Claude Code
claude mcp add stm32-docs --scope user -- python -m mcp_server

MCP Tools

The server provides 15+ tools for STM32 documentation: