feat(wokwi-ci/mcp-support): initial MCP server implementation

Author: urish

docs/wokwi-ci/getting-started.md

@@ -43,10 +43,15 @@ You can limit the simulation time for each test in your CI workflow using the `-
 wokwi-cli --timeout 10000
 ```
 
+## AI Agent Integration
+
+The Wokwi CLI includes experimental support for the [Model Context Protocol (MCP)](./mcp-support), enabling AI agents to interact with Wokwi's simulation capabilities. This allows AI assistants to run automated tests, simulate hardware behavior, and integrate Wokwi into AI-powered development workflows.
+
 ## Next Steps
 
 - [Install the Wokwi CLI](./cli-installation) to run your firmware on your local machine or CI system.
 - [Write automation scenarios](./automation-scenarios) to automate the simulation and test your firmware.
 - [Use Wokwi with GitHub Actions](./github-actions) to run your tests on every commit.
 - [Check out the example projects](./github-actions#examples) that are set up to run on Wokwi CI.
+- [Set up MCP support](./mcp-support) to integrate Wokwi with AI agents.
 - [Join the Wokwi Discord server](https://wokwi.com/discord) to get help and share your projects with the community.

docs/wokwi-ci/mcp-support.md

@@ -0,0 +1,37 @@
+# MCP Support
+
+## What is MCP?
+
+The Model Context Protocol (MCP) is an open standard that allows AI agents—such as Copilot, Claude Code, Cursor, and others to securely interact with external tools and services. For Wokwi users, MCP enables seamless integration between AI assistants and embedded simulation.
+
+## Wokwi MCP Server
+
+The Wokwi CLI includes an experimental MCP server that allows AI agents to interact with Wokwi's simulation and testing capabilities. This enables AI agents to:
+
+- Simulate complex embedded systems
+- Run automated tests on embedded projects
+- Monitor the serial console output and logs
+- Interact with the virtual hardware in real-time
+
+## Configuration
+
+To configure your AI agent to use the Wokwi MCP server, add the following to your agent's MCP configuration:
+
+```json
+{
+  "servers": {
+    "Wokwi": {
+      "type": "stdio",
+      "command": "wokwi-cli",
+      "args": ["mcp"],
+      "env": {
+        "WOKWI_CLI_TOKEN": "${input:wokwi-cli-token}"
+      }
+    }
+  }
+}
+```
+
+### Authentication
+
+You will need a valid Wokwi CLI token to use the MCP server. You can generate a token in the [Wokwi CI Dashboard](https://wokwi.com/dashboard/ci).

sidebars.js

@@ -99,6 +99,7 @@ module.exports = {
       'wokwi-ci/cli-usage',
       'wokwi-ci/github-actions',
       'wokwi-ci/automation-scenarios',
+      'wokwi-ci/mcp-support',
     ],
   },
 };