Omnispindle

의도적으로, 그리고 멋지게 잘못된 방향으로 나아간 todo 시스템.

Omnispindle은 Madness Interactive 생태계의 조정 중추입니다. 33개의 도구를 갖춘 Python FastMCP 서버로, AI 에이전트가 단일 표준화된 인터페이스를 통해 작업을 관리하고, 지식을 캡처하며, 세션을 조정하고, 전체 워크숍을 탐색할 수 있게 합니다. PyPI 패키지로 제공되며 Auth0가 통합되어 있습니다. MCP 설정이 있는 곳이라면 어디서든 실행됩니다.

이 프로젝트는 "todo를 제대로 해보자"는 생각에서 시작되었습니다. 결과적으로 다중 프로젝트 AI 보조 개발 연구소를 위한 중추 신경계가 되었습니다. 두 가지 모두 훌륭한 결과입니다.

실제 기능

Todo 관리 — 다른 모든 기능을 가능하게 하는 지루한 부분입니다. 에이전트는 전체 메타데이터, 우선순위, 대상 에이전트 추적 및 변경 사항 감지를 통해 생태계 내 모든 프로젝트의 작업을 생성, 조회, 업데이트, 완료 및 감사할 수 있습니다.

지식 캡처 — 학습한 내용은 언어, 주제 및 태그 메타데이터와 함께 저장됩니다. 정규식, 텍스트 또는 벡터 임베딩으로 검색할 수 있습니다. 대화가 끝나도 조직의 기억은 사라지지 않습니다.

세션 추적 — Inventorium에서의 AI 작업 세션은 포크(fork)하거나, 생성(spawn)하고, todo에 연결하며, 전체 계보 트리를 통해 추적할 수 있습니다. 모든 작업 스레드에는 부모와 계보가 있습니다.

의미론적 검색 — find_relevant는 벡터 임베딩을 사용하여 키워드뿐만 아니라 의미를 기반으로 todo와 학습 내용을 찾아냅니다. get_context_bundle은 에이전트에게 한 번의 호출로 전체 프로젝트 상황을 제공합니다.

Related MCP server: Coding Todo Server

설치

pip install omnispindle

설치 후 사용 가능한 CLI 명령어:

• omnispindle-stdio — Claude Desktop용 MCP stdio 서버

• omnispindle / omnispindle-server — 인증된 엔드포인트를 위한 HTTP 웹 서버

Claude Desktop (설정 불필요)

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을 사용하여 사용 가능한 도구와 에이전트의 토큰 예산을 제어하세요.

Todo 관리 (9개 도구)

지식 / 학습 (7개 도구)

Inventorium 세션 (8개 도구)

컨텍스트 및 검색 (2개 도구)

시스템 / 관리 (5개 도구)

사용자 정의 코드 (1개 도구)

도구 로드아웃

OMNISPINDLE_TOOL_LOADOUT을 설정하여 등록할 도구를 제어하세요:

작동 모드

OMNISPINDLE_MODE를 통해 설정:

• api — madnessinteractive.cc/api로의 HTTP 호출. 로컬 데이터베이스 불필요. 클라우드 네이티브 또는 다중 사용자 설정에 적합.

• 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)

모든 데이터는 데이터베이스 수준에서 사용자별로 범위가 지정됩니다. 당신의 todo는 당신만의 것입니다.

구성

# 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=<jwt>
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 인터페이스 계층입니다. 워크숍의 나머지 부분:

Inventorium — React 웹 대시보드 및 SwarmDesk 3D 공간 작업 공간. 인간이 사용합니다. AI 에이전트 전용인 MCP가 아닌 REST API를 통해 직접 todo와 세션을 읽습니다. 버튼을 클릭하고 있다면 Inventorium에 있는 것입니다. 에이전트라면 MCP 도구를 호출하는 것입니다.

cartogomancy — JS/TS 코드베이스 분석 도구 (npm install -g @madnessengineering/cartogomancy). JavaScript 또는 TypeScript 프로젝트를 지정하면 구조, 복잡성, git blame 및 상호 참조가 포함된 풍부한 JSON 맵을 얻을 수 있습니다. 이 맵을 SwarmDesk에 제공하면 코드베이스가 걸어 다닐 수 있는 3D 도시가 됩니다.

SwarmDesk — Inventorium 내부의 3D 공간 시각화 계층. todo, 세션 및 cartogomancy 코드 맵이 탐색 가능한 아키텍처로 렌더링됩니다. 프로젝트를 목록이 아닌 장소로 경험하세요.

MadnessVR — SwarmDesk의 Quest 2 VR 버전. 헤드셋을 착용하고 코드베이스를 실제 기하학적 구조로 걸어 다니세요. 이는 로드맵에 있으며 릴리스 노트에는 없습니다. 하지만 계획은 존재하며 상세합니다.

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

UI를 MCP를 통해 라우팅하지 마세요. AI 에이전트에서 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 도구, 3가지 작동 모드, 세션 계보 트리, 벡터 임베딩, 설정 불필요 OAuth, 그리고 VR에서 코드를 걸어 다니는 로드맵을 포함하여 만들었습니다.

이것이 적절한 복잡성입니다. 모든 조각이 중요한 역할을 합니다.

현재 작동 중:

• AI 에이전트를 위한 todo 관리 — 강력하고, 감사 가능하며, 사용자별로 분리됨

• 프로젝트 전반에 걸친 지속적인 지식 캡처

• 전체 계보를 포함한 세션 추적

• 벡터 임베딩을 통한 의미론적 검색

• 설정 가이드가 필요 없는 설정 불필요 Auth0

예정:

• MadnessVR: Quest 2에서의 SwarmDesk

• 테라리아 스타일의 인벤토리 메커니즘을 통한 프롬프트 엔지니어링 교육

• cartogomancy → SwarmDesk → VR로 이어지는 하나의 연속적인 파이프라인

우리는 신중하게 코드를 작성합니다. 실용적일 때는 경계를 넓히는 것을 두려워하지 않습니다.

*"과도하게 설계되었나요? 그럴지도 모릅니다. 야망이 부족한가요? 절대 아닙니다."" }

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers