Shannon Thinking

by olaservo

67 stars
235 downloads
Not rated
GitHub

About

A tool for systematic problem-solving based on Claude Shannon's methodology, breaking down complex problems into structured thoughts.

Details

Author
olaservo
GitHub stars
67
Downloads
235
Categories
Productivity, AI, Other

- Iterative problem-solving with revision and recheck capabilities
- Dependency tracking between successive thoughts
- Assumption management with explicit documentation
- Confidence levels quantifying uncertainty per step
- Flexible validation combining formal proofs and experimental testing

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Shannon Thinking
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via NPX by adding the server configuration to your MCP client's JSON config. Invoke the single shannonthinking tool with a structured thought object specifying content, type, number, total thoughts, confidence level, dependencies, and assumptions.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "shannon thinking": {
            "shannon-thinking": {
                "command": "npx",
                "args": [
                    "-y",
                    "server-shannon-thinking@latest"
                ]
            }
        }
    }
}

McpServers

{
    "shannon-thinking": {
        "command": "npx",
        "args": [
            "-y",
            "server-shannon-thinking@latest"
        ]
    }
}

A tool for systematic problem-solving based on Claude Shannon's methodology, breaking down complex problems into structured thoughts.

An MCP server demonstrating Claude Shannon's systematic problem-solving methodology. This server provides a tool that helps break down complex problems into structured thoughts following Shannon's approach of problem definition, mathematical modeling, and practical implementation.

Claude Shannon, known as the father of information theory, approached complex problems through a systematic methodology:
- Problem Definition: Strip the problem to its fundamental elements
- Constraints: Identify system limitations and boundaries
- Model: Develop mathematical/theoretical frameworks
- Proof/Validation: Validate through formal proofs or experimental testing
- Implementation/Experiment: Design and test practical solutions

This MCP server demonstrates this methodology as a tool that helps guide systematic problem-solving through these stages.

{ "mcpServers": { "shannon-thinking": { "command": "npx", "args": [ "-y", "server-shannon-thinking@latest" ] } } }

The server provides a single tool namedshannonthinkingthat structures problem-solving thoughts according to Shannon's methodology.

- The actual thought content
- Type (problem_definition/constraints/model/proof/implementation)
- Thought number and total thoughts estimate
- Confidence level (uncertainty: 0-1)
- Dependencies on previous thoughts
- Explicit assumptions
- Whether another thought step is needed

- Revision: Thoughts can revise earlier steps as understanding evolves
- Recheck: Mark steps that need re-examination with new information
- Experimental Validation: Support for empirical testing alongside formal proofs
- Implementation Notes: Practical constraints and proposed solutions

const thought = { thought: "The core problem can be defined as an information flow optimization", thoughtType: "problem_definition", thoughtNumber: 1, totalThoughts: 5, uncertainty: 0.2, dependencies: [], assumptions: ["System has finite capacity", "Information flow is continuous"], nextThoughtNeeded: true, // Optional: Mark as revision of earlier definition isRevision: false, // Optional: Indicate step needs recheck recheckStep: { stepToRecheck: "constraints", reason: "New capacity limitations discovered", newInformation: "System shows non-linear scaling" } }; // Use with MCP client const result = await client.callTool("shannonthinking", thought);

- Iterative Problem-Solving: Supports revisions and rechecks as understanding evolves
- Flexible Validation: Combines formal proofs with experimental validation
- Dependency Tracking: Explicitly tracks how thoughts build upon previous ones
- Assumption Management: Requires clear documentation of assumptions
- Confidence Levels: Quantifies uncertainty in each step
- Rich Feedback: Formatted console output with color-coding, symbols, and validation results

# Install dependencies npm install # Build npm run build # Run tests npm test # Watch mode during development npm run watch

The tool accepts thoughts with the following structure:

interface ShannonThought { thought: string; thoughtType: "problem_definition" | "constraints" | "model" | "proof" | "implementation"; thoughtNumber: number; totalThoughts: number; uncertainty: number; // 0-1 dependencies: number[]; assumptions: string[]; nextThoughtNeeded: boolean; // Optional revision fields isRevision?: boolean; revisesThought?: number; // Optional recheck field recheckStep?: { stepToRecheck: ThoughtType; reason: string; newInformation?: string; }; // Optional validation fields proofElements?: { hypothesis: string; validation: string; }; experimentalElements?: { testDescription: string; results: string; confidence: number; // 0-1 limitations: string[]; }; // Optional implementation fields implementationNotes?: { practicalConstraints: string[]; proposedSolution: string; }; }

This thinking pattern is particularly valuable for:

- Complex system analysis
- Information processing problems
- Engineering design challenges
- Problems requiring theoretical frameworks
- Optimization problems
- Systems requiring practical implementation
- Problems that need iterative refinement
- Cases where experimental validation complements theory

Great Question is an Agentic UX research platform for product builders. Its MCP lets AI agents create studies directly from any AI tool, surface insights, find the right research candidates, and query your entire research repository.

Create AI-moderated interviews and surveys via MCP and share survey links with participants instantly.

Multi-round AI debates between GPT, DeepSeek, Groq, and Claude — all models argue, critique, and synthesize inside your coding assistant.

Give your AI assistant the ability to identify cognitive blind spots. The official Model Context Protocol (MCP) server for cognitivebiaslabs.com.

A cognitive framework selector to help choose the right mental models and thinking frameworks for any situation.

An MCP server for advanced cognitive analysis, creative problem-solving, and structured thinking using the UCPF framework.

An MCP server implementation that provides a tool for problem-solving using the Lotus Sutra's wisdom framework, combining analytical thinking with intuitive wisdom.

A private, local research "second brain" for Claude — cited answers from your own library (it won't invent what it can't find), persistent project memory, daily briefs, a live meeting assistant, and 34 specialist agents. Runs entirely on your machine.

Let your CLI agents (Claude, Cursor, Codex...) chat directly with NotebookLM for zero-hallucination answers based on your own notebooks

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.