Omnispindle

基于FastMCP的任务和知识管理系统，适用于AI代理

Omnispindle 是Madness Interactive生态系统中的协调层。它提供了标准化的MCP工具，用于待办事项管理、经验教训捕获以及跨项目协调，使AI代理能够实际完成工作。

功能概述

对于AI代理：

• 添加、查询、更新和完成待办事项，并带有完整的审计日志
• 捕获并搜索跨项目的经验教训
• 访问项目感知的上下文和解释
• 在Madness Interactive生态系统中协调工作

对于人类：

• 通过Inventorium访问可视化仪表板
• 通过MQTT实时更新
• 通过MCP集成到Claude Desktop
• 项目感知的工作目录

未来展望：

• Terraria模组集成（工具作为库存物品——是的，真的）
• SwarmDesk 3D工作空间协调
• 针对所有技能水平的游戏化AI上下文管理

快速开始

🚀 自动认证（零配置！）

只需将Omnispindle添加到您的MCP客户端配置中：

{
  "mcpServers": {
    "omnispindle": {
      "command": "python",
      "args": ["-m", "src.Omnispindle.stdio_server"],
      "cwd": "/path/to/Omnispindle",
      "env": {
        "OMNISPINDLE_TOOL_LOADOUT": "basic"
      }
    }
  }
}

就这样！ 第一次使用Omnispindle工具时：

1. 🌐 浏览器自动打开进行Auth0登录
2. 🔐 使用Google（或Auth0凭证）登录
3. ✅ 令牌保存在本地以供将来使用
4. 🎯 所有MCP工具都能无缝地与您的认证上下文一起工作

无需复制令牌，无需手动配置文件，无需设置环境变量！

手动设置（可选）

如果您更喜欢手动配置：

# 安装依赖项
pip install -r requirements.txt

# 设置您的令牌（可选 - 自动认证会处理此问题）
export AUTH0_TOKEN="your_token_here"

# 运行MCP服务器
python -m src.Omnispindle.stdio_server

更多详情，请参阅MCP客户端认证指南。

架构

MCP工具 - 标准接口，用于AI代理管理任务 MongoDB - 带有审计轨迹的持久存储 MQTT - 组件之间的实时协调 FastMCP - 高性能的MCP服务器实现 Auth0/Cloudflare - 安全认证和访问控制

工具配置

通过配置OMNISPINDLE_TOOL_LOADOUT来控制可用的功能：

• basic - 基本的待办事项管理（7个工具）
• minimal - 核心功能（4个工具）
• lessons - 知识管理重点（7个工具）
• full - 全部功能（22个工具）

集成

作为Madness Interactive生态系统的一部分：

• Inventorium - 网络仪表板和3D工作空间
• SwarmDesk - 项目特定的AI环境
• Terraria集成 - 游戏化的AI交互（即将推出）

开发

# 运行测试
pytest tests/

# 启动STDIO MCP服务器（用于Claude Desktop）
python stdio_main.py

# 启动HTTP MCP服务器（用于远程访问）
python -m src.Omnispindle

# 检查工具注册
python -c "from src.Omnispindle.stdio_server import OmniSpindleStdioServer; print(len(OmniSpindleStd
StdioServer().server._tools))"

生产部署

方案1：本地STDIO（Claude Desktop）

对于本地开发和与像Claude Desktop这样的客户端一起使用，推荐使用stdio服务器。它现在支持通过Auth0令牌进行安全认证。

1. 获取您的Auth0令牌：请遵循MCP客户端认证指南中的说明。

2. 配置Claude Desktop：更新您的claude_desktop_config.json：

{
  "mcpServers": {
    "omnispindle": {
      "command": "python",
      "args": ["-m", "src.Omnispindle.stdio_server"],
      "cwd": "/path/to/Omnispindle",
      "env": {
        "AUTH0_TOKEN": "your_auth0_token_here",
        "OMNISPINDLE_TOOL_LOADOUT": "basic"
      }
    }
  }
}

这是目前使用Omnispindle与本地MCP客户端最推荐且最安全的方式。

方案2：远程HTTP（Cloudflare保护）

# 启动HTTP服务器
python -m src.Omnispindle

# 部署基础设施
cd OmniTerraformer/
./deploy.sh

配置MCP客户端：

{
  "mcpServers": {
    "omnispindle": {
      "command": "mcp-remote", 
      "args": ["https://madnessinteractive.cc/mcp/"]
    }
  }
}

隐私与安全

此仓库包含敏感配置：

• Auth0客户端凭证和域名设置
• 数据库连接字符串和API端点
• 包含业务逻辑的MCP工具实现
• 带有账户标识符的基础设施即代码

生产使用时：

• 为您的组织分叉此仓库
• 更新所有身份验证提供者和凭证
• 配置您自己的域名和SSL证书
• 查看并根据需要修改工具权限

不建议未经修改就公开部署。

哲学

我们构建的工具让AI代理真正有用，可以完成实际工作。简单界面，强大后端，以及足够的雄心壮志使其变得有趣。

今天的待办事项管理已经实现了。Terraria集成会让您的孩子比大多数成年人更擅长提示工程。3D工作空间会让远程工作感觉像是科幻小说。

但首先：正确管理好您的待办事项。

---

"复杂思维的简单工具，简单思维的复杂工具"