Clear Thought Server
平台与服务by chirag127
借助系统化思考、mental models 与调试方法增强解题能力,为复杂挑战提供结构化推理与决策支持,并可集成到兼容 MCP 的客户端工作流中。
什么是 Clear Thought Server?
借助系统化思考、mental models 与调试方法增强解题能力,为复杂挑战提供结构化推理与决策支持,并可集成到兼容 MCP 的客户端工作流中。
核心功能 (11 个工具)
sequentialthinkingA detailed tool for dynamic and reflective problem-solving through thoughts. This tool helps analyze problems through a flexible thinking process that can adapt and evolve. Each thought can build on, question, or revise previous insights as understanding deepens. When to use this tool: - Breaking down complex problems into steps - Planning and design with room for revision - Analysis that might need course correction - Problems where the full scope might not be clear initially - Problems that require a multi-step solution - Tasks that need to maintain context over multiple steps - Situations where irrelevant information needs to be filtered out You should: 1. Start with an initial estimate of needed thoughts, but be ready to adjust 2. Feel free to question or revise previous thoughts 3. Don't hesitate to add more thoughts if needed, even at the "end" 4. Express uncertainty when present 5. Mark thoughts that revise previous thinking or branch into new paths 6. Ignore information that is irrelevant to the current step 7. Generate a solution hypothesis when appropriate 8. Verify the hypothesis based on the Chain of Thought steps 9. Repeat the process until satisfied with the solution 10. Provide a single, ideally correct answer as the final output 11. Only set next_thought_needed to false when truly done and a satisfactory answer is reached
mentalmodelA tool for applying structured mental models to problem-solving. Supports various mental models including: - First Principles Thinking - Opportunity Cost Analysis - Error Propagation Understanding - Rubber Duck Debugging - Pareto Principle - Occam's Razor Each model provides a systematic approach to breaking down and solving problems.
designpatternA tool for applying design patterns to software architecture and implementation. Supports various design patterns including: - Modular Architecture - API Integration Patterns - State Management - Asynchronous Processing - Scalability Considerations - Security Best Practices - Agentic Design Patterns Each pattern provides a structured approach to solving common design challenges.
programmingparadigmA tool for applying different programming paradigms to solve problems. Supports various programming paradigms including: - Imperative Programming - Procedural Programming - Object-Oriented Programming - Functional Programming - Declarative Programming - Logic Programming - Event-Driven Programming - Aspect-Oriented Programming - Concurrent Programming - Reactive Programming Each paradigm provides a different approach to structuring and executing code.
debuggingapproachA tool for applying systematic debugging approaches to solve technical issues. Supports various debugging methods including: - Binary Search - Reverse Engineering - Divide and Conquer - Backtracking - Cause Elimination - Program Slicing Each approach provides a structured method for identifying and resolving issues.
collaborativereasoningA detailed tool for simulating expert collaboration with diverse perspectives. This tool helps models tackle complex problems by coordinating multiple viewpoints. It provides a framework for structured collaborative reasoning and perspective integration.
decisionframeworkA detailed tool for structured decision analysis and rational choice. This tool helps models systematically evaluate options, criteria, and outcomes. It supports multiple decision frameworks, probability estimates, and value judgments.
metacognitivemonitoringA detailed tool for systematic self-monitoring of knowledge and reasoning quality. This tool helps models track knowledge boundaries, claim certainty, and reasoning biases. It provides a framework for metacognitive assessment across various domains and reasoning tasks.
scientificmethodA detailed tool for applying formal scientific reasoning to questions and problems. This tool guides models through the scientific method with structured hypothesis testing. It enforces explicit variable identification, prediction making, and evidence evaluation.
structuredargumentationA detailed tool for systematic dialectical reasoning and argument analysis. This tool helps analyze complex questions through formal argumentation structures. It facilitates the creation, critique, and synthesis of competing arguments.
visualreasoningA tool for visual thinking, problem-solving, and communication. This tool enables models to create, manipulate, and interpret diagrams, graphs, and other visual representations. It supports various visual elements and operations to facilitate insight generation and hypothesis testing.
README
Clear Thought MCP Server
Systematic thinking, mental models, and debugging approaches — as MCP tools for any AI client.
What it is / why it exists
An MCP server that gives an AI assistant a toolbox of structured reasoning frameworks — mental models, design patterns, systematic debugging, decision analysis, the scientific method, and more — so it reasons deliberately instead of improvising. Each mode is an explicit, inspectable tool the model calls, with typed (Zod-validated) inputs and a formatted, chain-of-thought-friendly response.
Twelve tools, one server, zero required configuration.
Links
- Live MCP endpoint: https://clear-thought-mcp-server.oriz.in (Streamable HTTP, MCP 2.0)
- GitHub Pages: https://chirag127.github.io/Clear-Thought-MCP-server/
- Smithery: https://smithery.ai/server/@chirag127/clear-thought-mcp-server
- Repo: https://github.com/chirag127/Clear-Thought-MCP-server
⭐ If this is useful, please star the repo — it helps others find it.
Architecture
flowchart LR
Client["MCP Client<br/>(Claude, Cursor, opencode, ...)"]
subgraph Server["clear-thought-mcp-server"]
direction TB
T1["sequentialthinking"]
T2["mentalmodel"]
T3["designpattern"]
T4["programmingparadigm"]
T5["debuggingapproach"]
T6["collaborativereasoning"]
T7["decisionframework"]
T8["metacognitivemonitoring"]
T9["scientificmethod"]
T10["structuredargumentation"]
T11["visualreasoning"]
T12["stochasticthinking"]
end
Client -->|"Streamable HTTP (MCP 2.0) /mcp<br/>or stdio"| Server
Server -->|"formatted reasoning result"| Client
Tools
| Tool | What it does |
|---|---|
sequentialthinking | Dynamic, reflective step-by-step problem solving with revisions & branches |
mentalmodel | Apply a named model (first principles, Occam's razor, Pareto, opportunity cost, error propagation, rubber duck) |
designpattern | Software architecture patterns (modular, API integration, state, async, scalability, security, agentic) |
programmingparadigm | Reason through imperative / OO / functional / reactive / concurrent … paradigms |
debuggingapproach | Systematic debugging (binary search, reverse engineering, divide & conquer, backtracking, cause elimination, program slicing) |
collaborativereasoning | Simulate a panel of expert personas with diverse perspectives |
decisionframework | Structured decision analysis and rational choice |
metacognitivemonitoring | Self-monitor knowledge boundaries and reasoning quality |
scientificmethod | Formal hypothesis → experiment → analysis loop |
structuredargumentation | Dialectical reasoning — claims, rebuttals, synthesis |
visualreasoning | Create/manipulate diagrams and visual representations |
stochasticthinking | Probabilistic reasoning over uncertain problems |
Features
- 12 reasoning tools, each with a typed Zod input schema and formatted output
- Two transports: stdio (local clients) and Streamable HTTP (MCP 2.0, remote)
- Zero required configuration — no keys, no state, no external calls
- Installable via
npx, Smithery, or the hosted endpoint
Tech stack
- TypeScript + Node.js (ESM,
>=18) @modelcontextprotocol/sdk^1.29zodfor input validation,chalkfor formattingvitestfor tests,tscbuild
Repo structure
Clear-Thought-MCP-server/
├── src/
│ ├── index.ts # server bootstrap, tool registration, stdio + HTTP transports
│ ├── models/interfaces.ts # shared TypeScript interfaces
│ └── tools/ # one module per reasoning tool (mentalModelServer.ts, ...)
├── dist/ # compiled JS (tsc output)
├── test/ # vitest suites
├── Dockerfile # container image
├── smithery.yaml # Smithery deploy config
└── package.json
Quick start
Run with npx (stdio)
npx clear-thought-mcp-server
Install via Smithery
npx -y @smithery/cli install @chirag127/clear-thought-mcp-server --client claude
MCP client config
Hosted (Streamable HTTP):
{
"mcpServers": {
"clear-thought": {
"url": "https://clear-thought-mcp-server.oriz.in/mcp"
}
}
}
Local (stdio via npx):
{
"mcpServers": {
"clear-thought": {
"command": "npx",
"args": ["-y", "clear-thought-mcp-server"]
}
}
}
Run the HTTP transport yourself
npm install
npm run build
HTTP_PORT=3779 npm start # serves Streamable HTTP at http://localhost:3779/mcp
Register it
- MCP Registry: https://registry.modelcontextprotocol.io
- Smithery:
@chirag127/clear-thought-mcp-server— https://smithery.ai/server/@chirag127/clear-thought-mcp-server
Configuration
No configuration is required. Optional environment variables:
| Variable | Purpose |
|---|---|
HTTP_PORT | Port for the Streamable HTTP transport (default 3779) |
Part of the oriz family
One of ~80 sites and tools in the oriz family. It reasons; the Stochastic Thinking MCP Server handles probabilistic decision-making, and knowledge-mcp serves the knowledge base.
Contributing
Issues and PRs welcome. Conventional commits are the changelog.
License
MIT — see LICENSE.
Author
Chirag Singhal · chirag@oriz.in · @chirag127
Status
Stable (v1.1.2). Roadmap: more mental models, richer visual-reasoning output.
常见问题
Clear Thought Server 是什么?
借助系统化思考、mental models 与调试方法增强解题能力,为复杂挑战提供结构化推理与决策支持,并可集成到兼容 MCP 的客户端工作流中。
Clear Thought Server 提供哪些工具?
提供 11 个工具,包括 sequentialthinking、mentalmodel、designpattern 等。
相关 Skills
MCP构建
by anthropics
聚焦高质量 MCP Server 开发,覆盖协议研究、工具设计、错误处理与传输选型,适合用 FastMCP 或 MCP SDK 对接外部 API、封装服务能力。
✎ 想让 LLM 稳定调用外部 API,就用 MCP构建:从 Python 到 Node 都有成熟指引,帮你更快做出高质量 MCP 服务器。
Slack动图
by anthropics
面向Slack的动图制作Skill,内置emoji/消息GIF的尺寸、帧率和色彩约束、校验与优化流程,适合把创意或上传图片快速做成可直接发送的Slack动画。
✎ 帮你快速做出适配 Slack 的动图,内置约束规则和校验工具,少踩上传与播放坑,做表情包和演示都更省心。
接口测试套件
by alirezarezvani
扫描 Next.js、Express、FastAPI、Django REST 的 API 路由,自动生成覆盖鉴权、参数校验、错误码、分页、上传与限流场景的 Vitest 或 Pytest 测试套件。
✎ 帮你把API与集成测试自动化跑顺,减少回归漏测;能力全面,尤其适合复杂接口场景的QA团队。
相关 MCP Server
Slack 消息
编辑精选by Anthropic
Slack 是让 AI 助手直接读写你的 Slack 频道和消息的 MCP 服务器。
✎ 这个服务器解决了团队协作中需要 AI 实时获取 Slack 信息的痛点,特别适合开发团队让 Claude 帮忙汇总频道讨论或发送通知。不过,它目前只是参考实现,文档有限,不建议在生产环境直接使用——更适合开发者学习 MCP 如何集成第三方服务。
by netdata
io.github.netdata/mcp-server 是让 AI 助手实时监控服务器指标和日志的 MCP 服务器。
✎ 这个工具解决了运维人员需要手动检查系统状态的痛点,最适合 DevOps 团队让 Claude 自动分析性能数据。不过,它依赖 NetData 的现有部署,如果你没用过这个监控平台,得先花时间配置。
by d4vinci
Scrapling MCP Server 是专为现代网页设计的智能爬虫工具,支持绕过 Cloudflare 等反爬机制。
✎ 这个工具解决了爬取动态网页和反爬网站时的头疼问题,特别适合需要批量采集电商价格或新闻数据的开发者。不过,它依赖外部浏览器引擎,资源消耗较大,不适合轻量级任务。