{"id":30738855,"url":"https://github.com/philogicae/sequential-thinking-mcp","last_synced_at":"2025-09-03T22:11:01.093Z","repository":{"id":298899052,"uuid":"1001499268","full_name":"philogicae/sequential-thinking-mcp","owner":"philogicae","description":"Simpler alternative to sequential thinking MCP in python","archived":false,"fork":false,"pushed_at":"2025-08-25T11:56:27.000Z","size":737,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-25T13:31:59.606Z","etag":null,"topics":["mcp","sequential","think","thinking"],"latest_commit_sha":null,"homepage":"https://deepwiki.com/philogicae/sequential-thinking-mcp","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/philogicae.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-13T13:38:43.000Z","updated_at":"2025-08-25T11:56:22.000Z","dependencies_parsed_at":"2025-06-13T14:15:19.355Z","dependency_job_id":"6da173b9-f0d2-49d1-919c-5ab5f096e5d7","html_url":"https://github.com/philogicae/sequential-thinking-mcp","commit_stats":null,"previous_names":["philogicae/sequential-thinking-mcp"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/philogicae/sequential-thinking-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philogicae%2Fsequential-thinking-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philogicae%2Fsequential-thinking-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philogicae%2Fsequential-thinking-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philogicae%2Fsequential-thinking-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/philogicae","download_url":"https://codeload.github.com/philogicae/sequential-thinking-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philogicae%2Fsequential-thinking-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273518736,"owners_count":25120031,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mcp","sequential","think","thinking"],"created_at":"2025-09-03T22:10:59.547Z","updated_at":"2025-09-03T22:11:01.070Z","avatar_url":"https://github.com/philogicae.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sequential Thinking MCP\n\n[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://docs.astral.sh/uv/getting-started/installation/)\n[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)\n[![PyPI](https://badge.fury.io/py/sequential-thinking-mcp.svg?cache-control=no-cache)](https://badge.fury.io/py/sequential-thinking-mcp)\n[![Actions status](https://github.com/philogicae/sequential-thinking-mcp/actions/workflows/python-package-ci.yml/badge.svg?cache-control=no-cache)](https://github.com/philogicae/sequential-thinking-mcp/actions)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/philogicae/sequential-thinking-mcp)\n\nThis repository provides an MCP (Model Context Protocol) server that enables an AI agent to perform advanced meta-cognition and dynamic, reflective problem-solving.\n\nThis version of Sequential Thinking is quite different than the original one, as it only forces the agent to virtually log its thoughts and plans, without actually doing anything, except prompting itself. I found it to be sufficient enough for any kind of LLMs.\n\n\u003ca href=\"https://glama.ai/mcp/servers/@philogicae/sequential-thinking-mcp\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@philogicae/sequential-thinking-mcp/badge?cache-control=no-cache\" alt=\"Sequential Thinking MCP\" /\u003e\n\u003c/a\u003e\n\n## Table of Contents\n\n- [Features](#features)\n- [Setup](#setup)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n    - [Install from PyPI (Recommended)](#install-from-pypi-recommended)\n    - [For Local Development](#for-local-development)\n    - [For Docker](#for-docker)\n- [Usage](#usage)\n  - [As MCP Server](#as-mcp-server)\n  - [Via MCP Clients](#via-mcp-clients)\n    - [Example with Windsurf](#example-with-windsurf)\n- [Contributing](#contributing)\n- [Changelog](#changelog)\n- [License](#license)\n\n## Features\n\n-   **Advanced Meta-Cognition**: Provides a `think` tool for dynamic and reflective problem-solving through thought logging.\n-   **Agentic Workflow Orchestration**: Guides AI agents through complex tasks by breaking them into precise, manageable, and traceable steps.\n-   **Iterative Refinement**: Assesses the success of each step and self-corrects if necessary, adapting to new information or errors.\n-   **Proactive Planning**: Utilizes `left_to_be_done` for explicit future state management and task estimation.\n-   **Tool Recommendation**: Suggests specific tools via `tool_recommendation` to execute planned actions or gather necessary information.\n\n## Setup\n\n### Prerequisites\n\n-   Python 3.10+\n-   [`uv`](https://github.com/astral-sh/uv) (for local development)\n\n### Installation\n\nChoose one of the following installation methods.\n\n#### Install from PyPI (Recommended)\n\nThis method is best for using the package as a library or running the server without modifying the code.\n\n1.  Install the package from PyPI:\n```bash\npip install sequential-thinking-mcp\n```\n2.  Run the MCP server (default: stdio):\n```bash\npython -m sequential_thinking\n```\n\n#### For Local Development\n\nThis method is for contributors who want to modify the source code.\nUsing [`uv`](https://github.com/astral-sh/uv):\n\n1.  Clone the repository:\n```bash\ngit clone https://github.com/philogicae/sequential-thinking-mcp.git\ncd sequential-thinking-mcp\n```\n2.  Install dependencies using `uv`:\n```bash\nuv sync --locked\n```\n3.  Run the MCP server (default: stdio):\n```bash\nuv run -m sequential_thinking\n```\n\n#### For Docker\n\n1.  Clone the repository (if you haven't already):\n```bash\ngit clone https://github.com/philogicae/sequential-thinking-mcp.git\ncd sequential-thinking-mcp\n```\n2.  Build and run the container using Docker Compose (default port: 8000):\n```bash\ndocker compose up --build -d\n```\n3.  Access container logs:\n```bash\ndocker logs sequential-thinking-mcp -f\n```\n\n## Usage\n\n### As MCP Server\n\n```python\nfrom sequential_thinking import mcp\n\nmcp.run(transport=\"sse\")\n```\n\n### Via MCP Clients\n\nUsable with any MCP-compatible client. Available tools:\n\n-   `think`: Log a thought, plan next steps, and recommend tools.\n\n#### Example with Windsurf\nConfiguration:\n```json\n{\n  \"mcpServers\": {\n    ...\n    # with stdio (only requires uv)\n    \"sequential-thinking-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [ \"sequential-thinking-mcp\" ]\n    },\n    # with docker (only requires docker)\n    \"sequential-thinking-mcp\": {\n      \"command\": \"docker\",\n      \"args\": [ \"run\", \"-i\", \"-p\", \"8000:8000\", \"philogicae/sequential-thinking-mcp:latest\", \"sequential-thinking-mcp\" ]\n    },\n    # with sse transport (requires installation)\n    \"sequential-thinking-mcp\": {\n      \"serverUrl\": \"http://127.0.0.1:8000/sse\"\n    },\n    # with streamable-http transport (requires installation)\n    \"sequential-thinking-mcp\": {\n      \"serverUrl\": \"http://127.0.0.1:8000/mcp\" # not yet supported by every client\n    },\n    ...\n  }\n}\n```\n\n## Changelog\n\nSee [CHANGELOG.md](CHANGELOG.md) for a history of changes to this project.\n\n## Contributing\n\nContributions are welcome! Please open an issue or submit a pull request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilogicae%2Fsequential-thinking-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphilogicae%2Fsequential-thinking-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilogicae%2Fsequential-thinking-mcp/lists"}