Omnispindle (Dan Edens)

全向主轴

一个完美的待办事项系统，故意出错。

Omnispindle是Madness Interactive生态系统的协调核心，它是一个Python FastMCP服务器，有33个工具，让AI代理从一个标准化的界面管理任务、获取知识、协调会话和导航整个研讨会。PyPI已打包。Auth0已集成。在MCP配置所在的任何地方运行。

它最初是“让我们正确地做待办事项”。它成为了一个多项目人工智能辅助开发实验室的中枢神经系统。这两件事都很好。

______________________________________________________________________

它实际上做了什么

待办事项管理 --无聊的部分使其他一切成为可能。代理可以在生态系统中的任何项目中创建、查询、更新、完成和审计任务，并具有完整的元数据、优先级、目标代理跟踪和更改检测。

知识获取 --经验教训与语言、主题和标签元数据一起存储。可通过正则表达式、文本或向量嵌入进行搜索。谈话结束后，机构记忆不会消失。

会话跟踪 --Inventoryum中的AI工作会话可以分叉、生成、链接到待办事项，并通过完整的家谱树进行跟踪。每一项工作都有一个父母和一个血统。

语义搜索 — find_relevant 使用向量嵌入来按意义而不仅仅是关键字来显示待办事项和课程。 get_context_bundle 在一次通话中向代理人提供完整的项目情况。

______________________________________________________________________

安装

pip install omnispindle

安装后可用的CLI命令：

• omnispindle-stdio --Claude Desktop的MCP stdio服务器
• omnispindle / omnispindle-server --用于经过身份验证的端点的HTTP web服务器

克劳德桌面（零配置）

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "omnispindle": {
      "command": "omnispindle-stdio",
      "env": {
        "OMNISPINDLE_MODE": "api",
        "OMNISPINDLE_TOOL_LOADOUT": "basic",
        "MCP_USER_EMAIL": "you@example.com"
      }
    }
  }
}

第一个工具调用会打开浏览器进行Auth0登录。令牌保存在本地。就这样

发展

git clone https://github.com/DanEdens/Omnispindle.git
cd Omnispindle
pip install -r requirements.txt
python -m src.Omnispindle.stdio_server

______________________________________________________________________

工具

满载是6个类别的33个工具。通过以下方式控制可用内容以及代理的代币预算 OMNISPINDLE_TOOL_LOADOUT.

待办事项管理（9个工具）

知识/课程（7个工具）

Inventory会议（8个工具）

上下文和搜索（2个工具）

系统/管理（5个工具）

自定义代码（1个工具）

______________________________________________________________________

工具装载

集 OMNISPINDLE_TOOL_LOADOUT 要控制注册的内容：

______________________________________________________________________

操作模式

通过设置 OMNISPINDLE_MODE:

• api --HTTP调用 madnessinteractive.cc/api。不需要本地数据库。最适合云原生或多用户设置。
• hybrid *（默认）* -首先使用MongoDB回退的API。当网络不可靠时。
• local --仅限直接MongoDB连接。适合线下开发。
• auto --对两者进行基准测试，并选择速度更快的一个。

______________________________________________________________________

认证

零配置设备流：在第一次工具调用时，将打开一个浏览器窗口用于Auth0登录。令牌保存在本地。所有后续呼叫都经过身份验证，无需任何配置。

手动设置令牌 （可选）：

python -m src.Omnispindle.token_exchange

环境变量:

• MADNESS_AUTH_TOKEN 或 AUTH0_TOKEN --来自Auth0设备流的JWT
• MCP_USER_EMAIL --每用户数据隔离所需
• MADNESS_API_URL -覆盖API基础（默认值： https://madnessinteractive.cc/api)

所有数据都在数据库级别按用户进行范围划分。你的待办事项始终属于你。

______________________________________________________________________

配置

# Operation mode
OMNISPINDLE_MODE=hybrid          # api | hybrid | local | auto
OMNISPINDLE_TOOL_LOADOUT=basic   # see loadouts table above
OMNISPINDLE_FALLBACK_ENABLED=true
OMNISPINDLE_VALIDATE_PROJECT_NAMES=false  # optional: enable slower DB-backed project validation

# Authentication
MADNESS_AUTH_TOKEN=
MCP_USER_EMAIL=you@example.com

# Local/hybrid database
MONGODB_URI=mongodb://localhost:27017
MONGODB_DB=swarmonomicon

# Real-time events
MQTT_HOST=localhost
MQTT_PORT=1883

______________________________________________________________________

生态系统

Omnispindle是AI接口层。研讨会的其余部分：

库存 --React web仪表板和SwarmDesk 3D空间工作区。人类使用这个。它通过REST API直接读取todo和会话，而不是MCP，后者严格适用于AI代理。如果您正在单击按钮，则表示您处于Inventoryum中。如果你是一名代理，你会打电话给MCP工具。

漫画家 --JS/TS代码库分析工具(npm install -g @madnessengineering/cartogomancy).指向任何JavaScript或TypeScript项目；获取结构、复杂性、git责备和交叉引用的丰富JSON映射。将该地图输入SwarmDesk，您的代码库将变成一个您可以穿过的3D城市。

SwarmDesk --Inventoryum内部的三维空间可视化层。Todos、会话和卡通代码地图呈现为可探索的架构。你的项目是一个地方，而不是一个列表。

疯狂VR --任务2 VR版的SwarmDesk。戴上耳机，以实际几何体的形式浏览代码库。这个在路线图上，而不是发行说明上。但该计划确实存在，而且很详细。

Cogwyrm --AI聊天伴侣融入生态系统。在对话中使用Omnispindle MCP工具读取和写入共享上下文。

Swarmonomicon --核心数据库层。MongoDB， swarmonomicon 数据库。一切执着的东西都生活在这里。

架构规则

UI (Inventorium, forms, dashboards) → REST API → Database
AI agents (Claude, Cogwyrm, any MCP client) → MCP tools → Backend → Database

切勿通过MCP路由UI。切勿直接从人工智能代理调用REST API。这种分离是有意的，也是承重的。

______________________________________________________________________

发展

# Tests
pytest tests/

# Stdio server (Claude Desktop)
python -m src.Omnispindle.stdio_server

# Web server
python -m src.Omnispindle

# Check tool count
python -c "from src.Omnispindle.tool_loadouts import _BASE_LOADOUTS; print(len(_BASE_LOADOUTS['full']), 'tools in full loadout')"

PyPI出版

# Build and check
python -m build
python -m twine check dist/*

# Publish
python -m twine upload dist/*

______________________________________________________________________

隐私和安全

此仓库包含Auth0配置和基础设施作为我们生态系统的代码。它是开源的，用于学习和分叉，而不是按原样部署。

如果您实际上是为自己的设置运行此程序：

1. 叉起来
2. 替换所有身份验证提供程序和凭据
3. 将其指向您自己的域和数据库
4. 检查工具权限（默认情况下我们是允许的）

这是我们实验室的工作系统。对于你的，让它成为你的。

______________________________________________________________________

哲学

大多数人构建一个具有5个功能的todo应用程序。我们构建了一个包含33个MCP工具、三种操作模式、会话谱系树、向量嵌入、零配置OAuth和一个包括在VR中遍历代码的路线图。

这是适当的复杂性。每一块都是承重的。

现在工作：

• 人工智能代理的Todo管理——强大、经过审计、按用户
• 跨项目持续获取知识
• 具有完整沿袭的会话跟踪
• 基于向量嵌入的语义搜索
• 零配置Auth0，不需要安装指南

即将到来：

• 疯狂VR：任务2上的SwarmDesk
• 通过Terraria式库存机制教授快速工程
• 漫画家→ SwarmDesk→ VR作为一条连续的管道

我们编写谨慎的代码。在可行的情况下，我们不怕突破界限。

______________________________________________________________________

*“过度设计？也许吧。野心勃勃？从来没有。”*