P2 Knowledge Base MCP

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工具的指南。每个都为您的操作系统使用单一平台包：

您下载的内容： 特定于平台的小型存档，例如。 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，并针对真实硬件进行验证，从而完成从数据表到工作驱动程序的循环。

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知识库中获取并缓存内容。您不需要手动下载任何文档；服务器会自动处理它。

知识库包括：

______________________________________________________________________

文档

• 更新日志 --版本历史
• API 参考 --MCP工具规范（面向开发人员）
• 测试和覆盖范围 --测试策略和指标

许可证

MIT许可证——见 许可证 了解详情。

相关

• P2知识库 --文档来源
• OBEX --视差对象交换
• 螺旋桨2 --微控制器
• 模型上下文协议 --MCP规范

______________________________________________________________________

*铁羊制作有限责任公司*