mcpField
T
text-to-reality

text-to-reality

本地服务
github.com游戏娱乐13 周前更新
代码仓库访问官网

关于 text-to-reality

text-to-reality 是供 Agent 使用的本地设备构建规划工具，可将设备构想整理为经过检查的项目包。它提供零件、可打印部件、接线、代码、测试和图解装配指南，适合缺乏电子经验的制作者。

主要功能

  1. 01生成分阶段的设备构建包
  2. 02整理零件清单和接线详情
  3. 03记录可打印部件和固件
  4. 04生成图解装配指南
  5. 05验证文件并追踪构建历史

适用场景

  1. 01根据自然语言构想规划设备
  2. 02为新手准备装配指南
  3. 03组装前检查项目包

MCP 相关

本地 MCP 服务提供创建项目、记录文件、验证构建包、维护构建历史，以及查询开发板布局和插接式零件的工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "ai-wes-text-to-reality": {
      "command": "uvx",
      "args": [
        "text-to-reality"
      ],
      "env": {
        "TEXT_TO_REALITY_DIR": "<TEXT_TO_REALITY_DIR>"
      }
    }
  }
}
启动命令uvx text-to-reality
需要配置的环境变量
TEXT_TO_REALITY_DIRFolder where build projects are saved (default: ./text-to-reality)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypitext-to-reality0.1.1

工具

13

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

text-to-reality

赋予你的 Agent 构建真实物品的能力。

text-to-cad 能制作零件。text-to-reality 能制作可运行的设备。

License: MIT PyPI Python

描述你想要实现的东西。你的 Agent 会将它变成一套构建资料包， 任何人都可以按照图片组装：

  • 零件清单，可直接订购，所用零件都能插接在一起
  • 可 3D 打印的零件，用于外壳和支架
  • 接线方案，列出每根线以及它要插入的连接器
  • 代码，可直接加载
  • 分步图片指南，为从未制作过电子设备的人编写
  • 测试，让你知道设备是否正常工作

无需焊接、无需面包板，也不需要电子方面的经验。它在你的机器上运行：无需账户、 无需 API 密钥，你的项目也只是由你拥有的普通文件夹。

示例：Agent Meter

“给我做一个桌面小角色，能显示我的编码 Agent 正在做什么，以及我还剩多少 Claude 额度。”

Agent Meter：一个带头部屏幕的小型 3D 打印机器人角色（概念渲染图）

Agent Meter 展示了这一工作流：在 3D 打印角色内部安装一块 Seeed Studio XIAO ESP32-S3 和一块小屏幕，使用插接式连接器接线，并配备固件和图片指南。它的面部会显示你的 Agent 正在工作、已完成或在等待你，还会显示剩余额度。

获取 Agent Meter 套件 →

安装

向你的 Agent 提出请求
Install text-to-reality from https://github.com/ai-wes/text-to-reality

你也可以自行安装。text-to-reality 通过 uv 运行： 使用 uv --version 检查是否已安装，或使用 uv 的安装程序。然后运行 对应 Agent 的命令并重启它。

Claude Code
claude plugin marketplace add ai-wes/text-to-reality
claude plugin install text-to-reality@ai-wes

更新：运行 claude plugin marketplace update ai-wes，然后运行 claude plugin update text-to-reality@ai-wes。

Codex
codex plugin marketplace add ai-wes/text-to-reality
codex plugin add text-to-reality@ai-wes
Cursor

Cursor 也会加载 Claude Code 插件；如果已经安装该插件，请跳过此步骤。

git clone --depth 1 https://github.com/ai-wes/text-to-reality ~/.cursor/plugins/local/text-to-reality
Claude Desktop

将服务添加到 Claude Desktop 的配置中（Settings > Developer > Edit Config），然后 重启。如果它找不到 uvx，请使用其完整路径（which uvx）。

{
  "mcpServers": {
    "text-to-reality": {
      "command": "uvx",
      "args": ["--no-config", "--managed-python", "--python", "3.13", "--from", "text-to-reality==0.1.1", "text-to-reality", "mcp"]
    }
  }
}

项目会保存在应用启动目录下的 text-to-reality/ 文件夹中；设置 env 中的 TEXT_TO_REALITY_DIR 可选择其他文件夹。

其他 Agent
npx skills add ai-wes/text-to-reality

然后将上面的 MCP 服务添加到你的 Agent 的 MCP 配置中。

与 text-to-cad 搭配使用

text-to-reality 负责规划整个设备；text-to-cad 擅长制作 3D 打印零件。安装两者后，如果 text-to-cad 可用，Agent 就会用它来制作 3D 打印零件。

工作原理

每次构建都对应一个文件夹。Agent 会填写并检查七个阶段：

阶段内容
需求brief.md：设备功能、尺寸、电源、预算，以及如何确认设备正常工作
零件bom.json：每种零件及其数量
3D 打印零件CAD 源文件及 STL/3MF 文件
电子部分wiring.json：每根线、线的颜色及其连接器
代码固件源代码及其加载方法
组装图片指南
测试要检查的内容，以及通过标准

本地 MCP 服务为 Agent 提供工具，可用于创建项目、记录文件、检测检查后被编辑过的文件、验证资料包、保留构建历史，以及查询开发板排针布局和插接式零件。

你也可以自行检查文件夹：

uvx text-to-reality check ./text-to-reality/my-build

可拼接的部件

松散的跳线容易脱落，也容易接错。JIG_ 制作的连接器可将连接到同一排引脚的导线合并成一个插头，让接线变成插接。

Agent 默认使用 JIG_ 连接器。它会查找每块板的引脚排，为每排选择一个连接器，列出需要购买的物品，并标注连接器无法适配的引脚排。 前往 jig-robotics.com 购买 →

每个连接器由一个用于按顺序固定导线的底座和一个可扣上的盖子组成。图片指南会演示如何装入导线、合上盖子并将其插上。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。