P2知识库MCP
将您的AI助手变成Parallax Propeller 2的交互式参考手册。
______________________________________________________________________
你能做什么
安装后，只需用简单的英语问你的AI。以下是一些可能的例子：
PASM2装配参考
你的AI变成了一本交互式PASM2手册——询问任何指令，并获得语法、操作数、标志效果、编码细节和使用示例。
*“解释MOV指令——它会影响哪些标志？”* *“RDLONG和RDLUT有什么区别？”* *“显示PASM2的所有条件执行前缀。”* *“WAITX是如何工作的？你能举一个微秒延迟循环的例子吗？”*
Spin2语言帮助
获取任何内置Spin2方法的详细信息——参数、返回值以及如何使用它们。
*“如何使用PINSTART配置智能引脚？”* *Spin2 SEND方法的参数是什么* *“列出所有Spin2字符串处理方法。”* *“演示如何在Spin2中设置串行端口。”*
P2硬件和架构
询问COG、HUB内存、智能引脚、时钟配置和其他硬件主题。
*“P2 HUB内存总线是如何工作的？”* *“解释PWM输出可用的智能引脚模式。”* *“P2有多少COG，他们如何共享资源？”* *“P2时钟配置选项是什么？”*
OBEX社区代码
在Parallax对象交换中搜索并发现约113个社区对象——P2社区贡献的驱动程序、库和示例。
*“给我找一个用于驱动WS2812B LED的OBEX对象。”* *“OBEX中有I2C传感器驱动程序吗？”* *“显示可用的电机控制对象。”* *“Jon McPhalen发布了哪些OBEX对象？”*
跨主题问题
结合知识领域——你的人工智能可以在一次对话中从知识库的多个部分中提取。
*“我需要在PASM2中插入SPI。向我展示相关说明，然后找到一个我可以使用的OBEX对象。"* *“帮助我了解如何从Spin2启动PASM2 COG——涉及哪些Spin2方法和PASM2指令？”*
______________________________________________________________________
安装
P2KB MCP支持Claude（桌面和代码）、游标和Codex。几乎每个人都想要 标准单平台安装 --一个平台下载，将二进制文件放入 /opt/p2kb-mcp/ （或 C:\Program Files\p2kb-mcp\)并将其连接到您的AI工具。三个步骤：下载、安装、连接。
标准安装（推荐给几乎所有人）
选择AI工具的指南。每个都为您的操作系统使用单一平台包：
| 指南 | 适用 |
|---|---|
| 安装.md | 克劳德桌面 和 克劳德代码 --Windows、macOS和Linux |
| 安装冷凝器.md | 光标 IDE |
| 安装-CODEX.md | OpenAI 代码专家 CLI和IDE扩展 |
您下载的内容： 特定于平台的小型存档，例如。 p2kb-mcp-vX.X.X-darwin-arm64.tar.gz 在Apple Silicon上， p2kb-mcp-vX.X.X-windows-amd64.zip 在Windows上。它只包含您机器的二进制文件和文档。
高级：容器工具安装
分离的 container-tools-p2kb-mcp-vX.X.X.tar.gz 软件包存在于特定的利基市场：运行 多个 MCP服务器，并希望它们位于共享 /opt/container-tools/ 具有统一安装程序的树，共享 mcp.json，更新时的自动备份/回滚，以及Claude Code生命周期挂钩。它提供二进制文件 全部 平台与 install.sh 脚本。
除非您已经将容器工具框架用于其他MCP， 跳过这个 --上述标准安装更简单，对单个MCP也能完成相同的工作。如果它适用于您，请参阅 安装-验证.md.
______________________________________________________________________
使用PNut TS进行配对编程
有了这三个工具，你就可以给出高层次的工程意图，剩下的就由你的人工智能来处理了：
*“我需要一个FIFO来将数据从一个COG排队到另一个。将其创建为独立的Spin2对象。”* *为FIFO编写回归测试——测试空、满、溢出和下溢条件* *“在P2上运行回归测试，确保FIFO完全正常工作。”* *“现在添加一个PASM2驱动器COG，以10 kHz的频率将传感器读数推入FIFO。”*
您的AI从知识库中查找正确的PASM2指令和Spin2方法，编写代码，并使用 pnut-ts，下载到P2 pnut-term-ts，读取调试输出，并迭代直到测试通过——所有这些都是在单个对话中自主完成的。
或者从硬件方面开始——给你的人工智能一个新的外围设备，让它规划架构：
*“这是BME280传感器的数据表。它支持哪些接口选项，我们可以实现什么数据速率？”* *“哪种P2功能最适合与此设备通信——智能引脚SPI、比特碰撞还是其他什么？”* *“在给定P2时钟和指令定时的情况下，向我展示每种方法可以实现的性能。”* *“为驾驶员制定架构计划。”*
您的AI在线研究硬件文档，将接口要求与知识库中的P2功能（智能引脚模式、指令周期计时、流媒体带宽）进行映射，并在编写单行代码之前生成一个工程计划，显示可实现的内容。
然后，你连接硬件并将其交还给你的人工智能：
*“我已经将BME280连接到P2上——SDA在引脚40上，SCL在引脚41上，电源为3.3V。构建驱动器并验证它是否读取了有效的传感器数据。”*
从那里，你的AI生成具有正确引脚分配的代码，编译，下载到P2，并针对真实硬件进行验证，从而完成从数据表到工作驱动程序的循环。
| 工具 | 它提供了什么 |
|---|---|
| P2KB MCP | 准确的PASM2、Spin2和硬件知识，以便AI编写正确的P2代码 |
| PNut TS | 跨平台Spin2/PASM2编译器（Windows、macOS、Linux、RPi） |
| PNut术语TS | P2下载器+串口+调试显示（Windows、macOS、Linux、RPi） |
PNut TS和PNut Term TS是命令行工具，Claude Code、Codex和Cursor可以直接调用。除了将它们放在PATH中之外，不需要任何特殊配置。
提示： 安装PNut TS和PNut Term TS后，让您的AI学习它们：
*“跑pnut-ts --help和pnut-term-ts --help所以你知道如何使用P2编译器和终端工具。"*
这将教会你的AI完整的命令语法、标志和选项，这样它就可以在整个会话中有效地使用这两种工具。
AI就绪：无头模式
PNut术语TS包括 无头模式 专为AI代理和CI工作流而设计。这可以让你的AI将代码下载到P2，捕获串行/调试输出，并确定运行何时完成——所有这些都不需要GUI：
# Download to RAM, run until the program prints END_SESSION
pnut-term-ts --headless -r program.bin --end-marker
# Download to RAM, run for 30 seconds, then exit
pnut-term-ts --headless -r program.bin --timeout 30
# Wait for a custom end phrase in the output
pnut-term-ts --headless -r test.bin --end-marker "TEST_DONE"
# Download to FLASH for persistent storage
pnut-term-ts --headless -f program.bin --timeout 10在无头模式下，Spin2程序的所有串行和调试输出都会被捕获到日志文件中。当运行完成时，你的AI会读取日志，查看哪些有效，哪些无效，进行代码更正，并重新编译——这是一个在真实硬件上自主运行的完整编译-下载-测试-修复循环。
______________________________________________________________________
运作原理
P2KB MCP是一种 MCP服务器 --在您的计算机上本地运行的小程序。当你的AI工具需要Propeller 2信息时，它会查询MCP服务器，MCP服务器会从GitHub上的P2知识库中获取并缓存内容。您不需要手动下载任何文档；服务器会自动处理它。
知识库包括：
| 区域 | 内容 |
|---|---|
| PASM2 | 所有包含语法、编码、标志效果和示例的汇编指令 |
| Spin2 | 具有参数、返回值和用法的内置方法 |
| 建筑 | COG、HUB、智能引脚和硬件文档 |
| 指南 | 快速参考卡和入门材料 |
| OBEX | 约113个社区代码对象——驱动程序、库和演示 |
______________________________________________________________________
文档
许可证
MIT许可证——见 许可证 了解详情。
相关
______________________________________________________________________
*铁羊制作有限责任公司*