内容
# 奇点实验室
> 在虚拟芯片实例上模拟和验证固件，直接从您的AI编码代理——无需硬件。
[](LICENSE)
奇点实验室是一个托管的MCP服务。
您的AI编码代理连接到它，上传编译后的固件，在真实微控制器的虚拟实例上运行，并读取UART输出。
您不需要驱动工具链——您的代理会处理。
我们正在开放和早期阶段构建芯片开发的新方式。
今天，它在STM32和Nordic板上运行`Hello world!`；还有很多功能正在开发中——请参见 **[veecle.ai](https://veecle.ai)**。
试用它，探索它，并告诉我们您希望看到什么。
## 快速入门
1. 在 **[veecle.ai](https://veecle.ai)** 上创建免费账户（无需信用卡）。
2. 将您的代理连接到奇点实验室MCP服务器。
3. `git clone https://github.com/veecle/chiplab && cd chiplab`，然后告诉您的代理：
> *"设置奇点实验室并在其上运行stm32f4-discovery示例。"*
您的代理读取 [AGENTS.md](AGENTS.md)，安装所需内容，构建固件，上传它，在虚拟板上运行它，并从芯片的UART报告`Hello world!`。
这就是整个流程。
## 连接您的代理
奇点实验室是一个位于 `https://chiplab.veecle.ai/mcp` 的HTTP MCP服务器。
大多数客户端采用标准的 `mcpServers` 模式：
```json
{
"mcpServers": {
"chiplab": {
"type": "http",
"url": "https://chiplab.veecle.ai/mcp"
}
}
}
```
在首次使用时，您的客户端会打开浏览器进行登录。
要验证，请要求您的代理调用奇点实验室的发现/帮助工具，无需参数。
<details>
<summary><b>Claude 代码</b></summary>
如果您克隆了此仓库，服务器已经通过 [.mcp.json](.mcp.json) 配置——Claude 代码将提示您信任它。
否则：
```sh
claude mcp add --transport http chiplab https://chiplab.veecle.ai/mcp
```
</details>
<details>
<summary><b>Claude 桌面版 / Cursor</b></summary>
在 `claude_desktop_config.json` 或 `.cursor/mcp.json` 中使用上面的 `mcpServers` 块。
</details>
<details>
<summary><b>VS 代码</b></summary>
在 `.vscode/mcp.json` 中使用相同的块，但在 `servers` 键下而不是 `mcpServers`。
</details>
<details>
<summary><b>Codex</b></summary>
`~/.codex/config.toml` 中的TOML：
```toml
[mcp_servers.chiplab]
url = "https://chiplab.veecle.ai/mcp"
```
然后使用 `codex mcp login chiplab` 登录。
</details>
## 工作原理
合约是框架无关的：您的代理 **构建一个ELF → 上传它 → 在目标板上运行它 → 读取捕获的UART输出**。
运行同步返回并绑定到固定量的虚拟时间。
该仓库提供了每个受支持板子的现成示例，按框架分组—— [`bare-metal`](examples/bare-metal) （Rust，供应商HAL），[`embassy-rust`](examples/embassy-rust) （ [Embassy] 异步），[`zephyr-os`](examples/zephyr-os) （ [Zephyr RTOS] ，C）和 [`freertos`](examples/freertos) （ [FreeRTOS] ，C）。
完整的板子 × 框架矩阵在 **[supported-boards.md](supported-boards.md)** 中。
[Embassy]: https://embassy.dev
[Zephyr RTOS]: https://zephyrproject.org
[FreeRTOS]: https://www.freertos.org
工具链和构建细节位于每个框架的目录中（`examples/<framework>/README.md` 用于人类，`AGENTS.md` 用于代理）——您的代理会自行找到它们。
更喜欢手动构建？
每个框架的README都有确切的命令。
要运行您自己的固件，请为受支持的板子构建一个ELF，并要求您的代理以相同的方式上传和运行它。
## 贡献
添加板子示例是最简单的方法：镜像同一框架的现有示例，并向 [supported-boards.md](supported-boards.md) 添加一行。
所有约定都在 **[AGENTS.md](AGENTS.md)** 和每个框架的 `AGENTS.md` 中。
新的芯片、操作系统或外设支持在服务器端—— [打开请求][new-issue] 而不是为不受支持的板子添加示例。
[new-issue]: https://github.com/veecle/chiplab/issues/new/choose
## 发现了错误？缺少芯片？在这里告诉我们。
这是奇点实验室的公共主页——错误、功能想法和芯片/操作系统/外设请求都属于 [此仓库的问题][new-issue]。
请求确实会影响路线图——请参见 [veecle.ai/roadmap](https://veecle.ai/roadmap) 以查看计划内容，或在 [Discord](https://discord.com/invite/F6GwZJ6ktP) 上与我们聊天。
## 许可证
[MIT](LICENSE) 2026 Veecle GmbH.
