Skip to main content
Glama
olaservo

Shannon Thinking MCP Server

by olaservo

シャノン思考

クロード・シャノンの体系的な問題解決手法を示すMCPサーバー。このサーバーは、シャノンの問題定義、数学的モデリング、そして実践的な実装というアプローチに従って、複雑な問題を構造化された思考へと分解するのに役立つツールを提供します。

概要

情報理論の父として知られるクロード・シャノンは、体系的な方法論を通じて複雑な問題に取り組みました。

  1. 問題の定義: 問題を基本的な要素に分解する

  2. 制約: システムの制限と境界を特定する

  3. モデル:数学的/理論的枠組みを開発する

  4. 証明/検証: 正式な証明や実験テストを通じて検証する

  5. 実装/実験:実用的なソリューションを設計しテストする

この MCP サーバーは、これらの段階を通じて体系的な問題解決を導くツールとしてこの方法論を実証します。

Related MCP server: Sequential Thinking MCP Server

インストール

NPX

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

使用法

サーバーは、シャノンの方法論に従って問題解決の思考を構造化するshannonthinkingという単一のツールを提供します。

それぞれの考えには次の内容が含まれている必要があります。

  • 実際の思考内容

  • タイプ(問題定義/制約/モデル/証明/実装)

  • 思考回数と総思考数の推定

  • 信頼度(不確実性:0-1)

  • 過去の考えへの依存

  • 明示的な仮定

  • さらなる思考ステップが必要かどうか

追加機能:

  • 修正:理解が深まるにつれて、思考は以前のステップを修正することができます

  • 再確認: 再検討が必要な手順を新しい情報でマークします

  • 実験的検証:形式的証明と並行した経験的テストのサポート

  • 実装ノート:実際的な制約と提案された解決策

使用例

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

特徴

  • 反復的な問題解決:理解が深まるにつれて修正と再確認をサポートします

  • 柔軟な検証:形式的な証明と実験的な検証を組み合わせる

  • 依存関係の追跡: 思考が以前の思考の上にどのように構築されるかを明示的に追跡します

  • 仮定管理:仮定を明確に文書化する必要がある

  • 信頼度レベル: 各ステップにおける不確実性を定量化する

  • 豊富なフィードバック: 色分け、シンボル、検証結果を含むフォーマットされたコンソール出力

発達

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Watch mode during development
npm run watch

ツールスキーマ

このツールは、次の構造の考えを受け入れます。

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;
  };
}

いつ使うか

この思考パターンは、特に次のような場合に価値があります。

  • 複雑系分析

  • 情報処理の問題

  • エンジニアリング設計の課題

  • 理論的枠組みを必要とする問題

  • 最適化問題

  • 実用的な実装を必要とするシステム

  • 反復的な改善が必要な問題

  • 実験検証が理論を補完するケース

Available Tools

1 tool
shannonthinkingA

A problem-solving tool inspired by Claude Shannon's systematic and iterative approach to complex problems.

This tool helps break down problems using Shannon's methodology of problem definition, mathematical modeling, validation, and practical implementation.

When to use this tool:

  • 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

Key features:

  • Systematic progression through problem definition → constraints → modeling → validation → implementation

  • Support for revising earlier steps as understanding evolves

  • Ability to mark steps for re-examination with new information

  • Experimental validation alongside formal proofs

  • Explicit tracking of assumptions and dependencies

  • Confidence levels for each step

  • Rich feedback and validation results

Parameters explained:

  • thoughtType: Type of thinking step (PROBLEM_DEFINITION, CONSTRAINTS, MODEL, PROOF, IMPLEMENTATION)

  • uncertainty: Confidence level in the current thought (0-1)

  • dependencies: Which previous thoughts this builds upon

  • assumptions: Explicit listing of assumptions made

  • isRevision: Whether this revises an earlier thought

  • revisesThought: Which thought is being revised

  • recheckStep: For marking steps that need re-examination

  • proofElements: For formal validation steps

  • experimentalElements: For empirical validation

  • implementationNotes: For practical application steps

The tool supports an iterative approach:

  1. Define the problem's fundamental elements (revisable as understanding grows)

  2. Identify system constraints and limitations (can be rechecked with new information)

  3. Develop mathematical/theoretical models

  4. Validate through proofs and/or experimental testing

  5. Design and test practical implementations

Each thought can build on, revise, or re-examine previous steps, creating a flexible yet rigorous problem-solving framework.

ParametersJSON Schema
NameRequiredDescriptionDefault
thoughtYesYour current thinking step
isRevisionNoWhether this thought revises an earlier one
assumptionsYesExplicit list of assumptions
recheckStepNoFor marking steps that need re-examination
thoughtTypeYesType of thinking step
uncertaintyYesConfidence level (0-1)
dependenciesYesThought numbers this builds upon
proofElementsNoElements required for formal proof steps
thoughtNumberYesCurrent thought number
totalThoughtsYesEstimated total thoughts needed
revisesThoughtNoThe thought number being revised
nextThoughtNeededYesWhether another thought step is needed
implementationNotesNoNotes for practical implementation steps
experimentalElementsNoElements for experimental validation

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full responsibility for disclosing behavior. It thoroughly explains the iterative nature, support for revisions, re-examination, and tracking of assumptions and confidence levels. It leaves little ambiguity about how the tool operates.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured with clear sections but is somewhat verbose, especially the 'Key features' and iterative process parts which are partially redundant with the 'Parameters explained' and usage guidelines. It could be more concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (14 parameters, nested objects) and no output schema, the description is reasonably complete. It explains the methodology, parameter purposes, and iterative workflow. However, it does not specify what the tool returns or how errors are handled.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description's 'Parameters explained' section reiterates schema descriptions, adding some context (e.g., 'Which previous thoughts this builds upon') but does not provide significant new meaning beyond what the schema already states.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly defines the tool as a problem-solving tool inspired by Claude Shannon's systematic approach. It explicitly states the verb (break down problems) and resource (Shannon's methodology), and lists specific use cases, making its purpose unmistakable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides an extensive list of when to use the tool, covering complex systems, engineering, optimization, etc. It also outlines the iterative process and key features. However, it does not explicitly state when not to use the tool or suggest alternatives, but given no siblings, this is acceptable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool update
    • First observedshannonthinking

TDQS

A4/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no risk of confusion between tools. The tool's purpose is clearly described and stands alone.

Naming Consistency5/5

A single tool name 'shannonthinking' is trivially consistent. No naming conflicts or inconsistencies exist.

Tool Count2/5

One tool for a complex problem-solving methodology is minimal. The tool is monolithic, handling all thought types via parameters, which reduces modularity and discoverability.

Completeness4/5

The tool covers all key stages of problem-solving (definition, constraints, modeling, proof, implementation, iteration) and includes validation and revision features. However, packing everything into one tool limits granularity and specialized access.

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    An adaptation of the MCP Sequential Thinking Server designed to guide tool usage in problem-solving. This server helps break down complex problems into manageable steps and provides recommendations for which MCP tools would be most effective at each stage.
    1
    777 npm
    589
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides access to 27+ structured problem-solving frameworks and game-theoretic workflows for software development, project management, and operations research. Helps prevent analysis paralysis and scope creep by transforming open-ended challenges into systematic, time-boxed approaches with clear decision gates.
    5
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables structured step-by-step reasoning with branching, revisions, and self-critique to help break down complex problems into manageable steps with confidence tracking and thought history search.
    7
    19 npm
    7
    MIT