{"id":44388110,"url":"https://github.com/j0hanz/cortex-mcp","last_synced_at":"2026-03-01T07:09:47.579Z","repository":{"id":337842291,"uuid":"1155458663","full_name":"j0hanz/cortex-mcp","owner":"j0hanz","description":"Multi-level reasoning MCP server with configurable depth levels.","archived":false,"fork":false,"pushed_at":"2026-02-23T20:13:42.000Z","size":290,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-24T03:16:52.406Z","etag":null,"topics":["mcp","mcp-server","model-context-protocol","multi-level","reasoning","thinking","thoughts"],"latest_commit_sha":null,"homepage":"https://github.com/j0hanz/cortex-mcp#readme","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/j0hanz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-11T14:38:10.000Z","updated_at":"2026-02-23T20:13:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/j0hanz/cortex-mcp","commit_stats":null,"previous_names":["j0hanz/cortex-mcp"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/j0hanz/cortex-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0hanz%2Fcortex-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0hanz%2Fcortex-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0hanz%2Fcortex-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0hanz%2Fcortex-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/j0hanz","download_url":"https://codeload.github.com/j0hanz/cortex-mcp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j0hanz%2Fcortex-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29960296,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T01:47:18.291Z","status":"online","status_checked_at":"2026-03-01T02:00:07.437Z","response_time":124,"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","mcp-server","model-context-protocol","multi-level","reasoning","thinking","thoughts"],"created_at":"2026-02-12T01:45:39.483Z","updated_at":"2026-03-01T07:09:47.545Z","avatar_url":"https://github.com/j0hanz.png","language":"TypeScript","readme":"# Cortex MCP\n\n[![npm version](https://img.shields.io/npm/v/@j0hanz/cortex-mcp?style=flat-square\u0026logo=npm\u0026logoColor=white)](https://www.npmjs.com/package/@j0hanz/cortex-mcp) [![Release](https://github.com/j0hanz/cortex-mcp/actions/workflows/release.yml/badge.svg)](https://github.com/j0hanz/cortex-mcp/actions/workflows/release.yml) [![Node.js \u003e=24](https://img.shields.io/badge/Node.js-%3E%3D24-339933?style=flat-square\u0026logo=nodedotjs\u0026logoColor=white)](https://nodejs.org) [![TypeScript](https://img.shields.io/badge/TypeScript-5.9+-3178C6?style=flat-square\u0026logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=cortex-mcp\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fcortex-mcp%40latest%22%5D%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=cortex-mcp\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fcortex-mcp%40latest%22%5D%7D\u0026quality=insiders) [![Install in Visual Studio](https://img.shields.io/badge/Visual_Studio-Install_Server-C16FDE?logo=visualstudio\u0026logoColor=white)](https://vs-open.link/mcp-install?name=cortex-mcp\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40j0hanz%2Fcortex-mcp%40latest%22%5D%7D)\n\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=cortex-mcp\u0026config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBqMGhhbnovY29ydGV4LW1jcEBsYXRlc3QiXX0=) [![Add to LM Studio](https://files.lmstudio.ai/deeplink/mcp-install-light.svg)](https://lmstudio.ai/install-mcp?name=cortex-mcp\u0026config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBqMGhhbnovY29ydGV4LW1jcEBsYXRlc3QiXX0=)\n\nMulti-level reasoning MCP server with configurable depth levels. Designed for complex problem-solving that requires structured thought chains and session continuity across multiple tool calls.\n\n## Key Features\n\n- **Multi-level reasoning**: `basic` (3–5 thoughts), `normal` (6–10 thoughts), and `high` (15–25 thoughts).\n- **Session Continuity**: Maintain context across multiple tool calls with session IDs.\n- **Task Execution**: Supports long-running reasoning tasks with progress notifications.\n- **Resource Views**: Inspect active sessions and detailed reasoning traces via MCP resources.\n- **Completable Arguments**: Offers completions for session IDs, levels, and thought names.\n\n## Requirements\n\n- **Node.js**: \u003e= 24 (see `package.json` engines)\n- An MCP client that supports stdio servers.\n\n## Quick Start\n\nStandard config (works in most MCP clients):\n\n```json\n{\n  \"mcpServers\": {\n    \"cortex-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@j0hanz/cortex-mcp@latest\"]\n    }\n  }\n}\n```\n\n## Client Configuration\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Claude Desktop\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"cortex-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@j0hanz/cortex-mcp@latest\"]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in VS Code\u003c/b\u003e\u003c/summary\u003e\n\nAdd to your user `settings.json`:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"cortex-mcp\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"@j0hanz/cortex-mcp@latest\"]\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstall in Cursor\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"cortex-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@j0hanz/cortex-mcp@latest\"]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n## MCP Surface\n\n### Tools\n\n#### `reasoning_think`\n\nPerform multi-step reasoning on a query with a selected depth level.\n\n| Name             | Type         | Required | Default | Description                                                                   |\n| :--------------- | :----------- | :------- | :------ | :---------------------------------------------------------------------------- |\n| `query`          | string       | No       | -       | The question or problem to reason about (required for new sessions).          |\n| `level`          | enum         | No       | -       | Reasoning depth level: `basic`, `normal`, `high` (required for new sessions). |\n| `targetThoughts` | number       | No       | -       | Optional explicit thought count within the selected level range.              |\n| `sessionId`      | string       | No       | -       | Session ID to continue a previous reasoning session.                          |\n| `runMode`        | enum         | No       | `step`  | `step` appends one thought; `run_to_completion` consumes multiple thoughts.   |\n| `thought`        | string/array | Yes      | -       | Your full reasoning content for this step (verbatim).                         |\n| `thoughts`       | array        | No       | -       | (Deprecated) Additional thought inputs for `run_to_completion`.               |\n\n**Returns:** A structured result with session metadata, thoughts, and token usage.\n\n### Resources\n\n| URI Pattern                                               | Description                            | MIME Type          |\n| :-------------------------------------------------------- | :------------------------------------- | :----------------- |\n| `internal://instructions`                                 | Usage instructions for the MCP server. | `text/markdown`    |\n| `reasoning://sessions`                                    | List of active reasoning sessions.     | `application/json` |\n| `reasoning://sessions/{sessionId}`                        | Detailed view of a reasoning session.  | `application/json` |\n| `reasoning://sessions/{sessionId}/trace`                  | Markdown trace of a reasoning session. | `text/markdown`    |\n| `reasoning://sessions/{sessionId}/thoughts/{thoughtName}` | Markdown content of a single thought.  | `text/markdown`    |\n\n### Prompts\n\n| Name                 | Arguments                                       | Description                               |\n| :------------------- | :---------------------------------------------- | :---------------------------------------- |\n| `reasoning.basic`    | `query`, `targetThoughts`                       | Prepare a basic-depth reasoning request.  |\n| `reasoning.normal`   | `query`, `targetThoughts`                       | Prepare a normal-depth reasoning request. |\n| `reasoning.high`     | `query`, `targetThoughts`                       | Prepare a high-depth reasoning request.   |\n| `reasoning.retry`    | `query`, `level`, `targetThoughts`              | Retry a failed reasoning task.            |\n| `reasoning.continue` | `sessionId`, `query`, `level`, `targetThoughts` | Continue an existing reasoning session.   |\n| `get-help`           | -                                               | Return server usage instructions.         |\n\n### Tasks\n\nTask-augmented tool calls are supported for `reasoning_think`. Use `tools/call` with task support to run long-running reasoning sessions asynchronously.\n\n## Configuration\n\n### Environment Variables\n\n| Variable                            | Description                                    | Default            |\n| :---------------------------------- | :--------------------------------------------- | :----------------- |\n| `CORTEX_SESSION_TTL_MS`             | Session time-to-live in milliseconds.          | `1800000` (30 min) |\n| `CORTEX_MAX_SESSIONS`               | Maximum active in-memory sessions.             | `100`              |\n| `CORTEX_MAX_TOTAL_TOKENS`           | Maximum aggregate token usage across sessions. | `500000`           |\n| `CORTEX_MAX_ACTIVE_REASONING_TASKS` | Maximum concurrent background tasks.           | `32`               |\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the server\nnpm run build\n\n# Run in development mode\nnpm run dev\n\n# Run tests\nnpm run test\n\n# Launch MCP Inspector\nnpm run inspector\n```\n\n## Build \u0026 Release\n\nThe project uses GitHub Actions for CI/CD:\n\n- **Release**: Bumps version, validates, tags, and creates a GitHub release.\n- **Publish npm**: Publishes the package to npm.\n- **Publish MCP**: Publishes the server to the MCP Registry.\n- **Publish Docker**: Builds and pushes the Docker image to `ghcr.io`.\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj0hanz%2Fcortex-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj0hanz%2Fcortex-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj0hanz%2Fcortex-mcp/lists"}