stagsz/Unconventional-thinking

A context-efficient MCP server for bold, unconventional, and boundary-breaking problem-solving.
This is a TypeScript-based MCP server that implements an unconventional thinking system optimized for context space savings based on Anthropic's latest MCP architecture patterns. It generates and tracks creative solutions to problems while maintaining efficiency.
> MCP spec 2025-11-25 compliant — uses @modelcontextprotocol/sdk v1.27.1 with tool title, annotations, outputSchema, structuredContent responses, and resourcelink content type.
## Architecture: Context-Saving Design
This server demonstrates Anthropic's recommended patterns for reducing context overhead by 98.7%:
### Key Context-Saving Features
1. Resources API for On-Demand Data Loading
Thought content is stored as resources (thought://id)
Claude loads full content only when explicitly needed
Metadata is returned by default, saving tokens
2. Server-Side Filtering
searchthoughts filters data locally instead of passing unfiltered sets to Claude
Only matching results returned, not entire dataset
Reduces context consumption by filtering at the source
3. Metadata-First Returns
Tools return only essential metadata + resource URIs
Full thought content accessible via Resources API
Claude decides whether to fetch full content based on need
4. Persistent File-Based Storage
Data persists in .thoughts/ directory
No in-memory bloat accumulating across sessions
Easy to inspect and debug thoughts locally
## Features
### Tools (All Context-Efficient, MCP spec 2025-11-25)
Each tool now includes:
title — human-readable display name shown in client UIs
annotations — behaviour hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
outputSchema — JSON Schema describing the structured result
structuredContent in responses — machine-readable output conforming to the schema
resourcelink content items — explicit links clients can subscribe to or fetch
generateunreasonablethought — Generate new unconventional thoughts
Returns resourcelink + structuredContent, not raw text blobs
Can build upon or rebel against previous thoughts
Full thought content available via Resources API
branchthought — Create new branches of thinking
Supports directions: moreextreme, opposite, tangential (now enum-typed)
Returns resourcelink + structuredContent for the new branch
searchthoughts — Efficient metadata search
Filters by branchId, isRebellion, challengesAssumption
Returns structuredContent with typed count + thoughts array
Includes limit parameter to control result size
### Resources (On-Demand Content Loading)
Each thought available as a resource: thought://[thoughtId]
Metadata includes: isRebellion, challengesAssumption, timestamp, branch info
Full thought content loaded only when Claude explicitly requests it
Dramatically reduces token usage when many thoughts exist
## How This Implements Context Efficiency
### 1. Progressive Disclosure
Claude doesn't need the full content of 100 thoughts upfront. Instead:
searchthoughts returns just IDs and metadata (100 bytes per thought)