Claude MarketplacesSubmit

mcp-architector

thesharque/mcp-architect

Stores project architecture, module definitions, and data flow graphs locally in `~/.mcp-architector` with tools for setting and retrieving structure. Works with Cursor IDE and Claude Desktop via stdio. Exposes operations like `set-project-architecture`, `set-module-details`, `rebuild-data-flow`, and `validate-architecture` to manage vertical structure, plus entry and slice tools for horizontal facts like API endpoints and domain entities. Useful when you want Claude to understand your system's shape without sending architecture docs to the cloud. Includes a phased onboarding rule for Cursor agents that prevents dumping entire repos into context at once. All data stays on your machine.

tools: 24
transport: STDIO
last updated: Sep 27, 2026

Tools

24 tools

Public tool metadata for what this MCP can expose to an agent.

set-project-architectureCreates or updates the overall architecture for a project.

Creates or updates the overall architecture for a project.

No parameter schema in public metadata yet.

get-project-architectureRetrieves the overall architecture of the project.

Retrieves the overall architecture of the project.

No parameter schema in public metadata yet.

list-projectsLists all projects in local storage (~/.mcp-architector).

Lists all projects in local storage (~/.mcp-architector).

No parameter schema in public metadata yet.

set-entryUpsert one fact; response may include reminder if modules missing or unlinked.

Upsert one fact; response may include reminder if modules missing or unlinked.

No parameter schema in public metadata yet.

set-entriesBulk upsert (max 200); optional moduleName sets refs.moduleName on all.

Bulk upsert (max 200); optional moduleName sets refs.moduleName on all.

No parameter schema in public metadata yet.

get-entryFull entry by id.

Full entry by id.

No parameter schema in public metadata yet.

delete-entryRemove entry.

Remove entry.

No parameter schema in public metadata yet.

list-entriesCatalog without payload; filter by kind, tags, query.

Catalog without payload; filter by kind, tags, query.

No parameter schema in public metadata yet.

search-entriesCompact text search with snippet, slices, moduleName, pagination.

Compact text search with snippet, slices, moduleName, pagination.

No parameter schema in public metadata yet.

list-slicesBuilt-in + custom slices with entry counts.

Built-in + custom slices with entry counts.

No parameter schema in public metadata yet.

get-sliceFiltered view: sliceId, format, query, limit, offset, hasMore.

Filtered view: sliceId, format, query, limit, offset, hasMore.

No parameter schema in public metadata yet.

set-sliceSave custom filter (kinds, tags) — no items.

Save custom filter (kinds, tags) — no items.

No parameter schema in public metadata yet.

delete-sliceRemove custom slice.

Remove custom slice.

No parameter schema in public metadata yet.

rebuild-entry-indexRebuild entries/index.json from entry files.

Rebuild entries/index.json from entry files.

No parameter schema in public metadata yet.

fix-dataRepair leftover/corrupt catalog JSON; rebuild index.

Repair leftover/corrupt catalog JSON; rebuild index.

No parameter schema in public metadata yet.

set-module-detailsCreates or updates detailed information about a module.

Creates or updates detailed information about a module.

No parameter schema in public metadata yet.

set-module-data-flowPatches dataFlow for a single module without sending the full architecture.

Patches dataFlow for a single module without sending the full architecture.

No parameter schema in public metadata yet.

rebuild-data-flowRebuilds dataFlow for all modules from module file dependencies or existing dependsOn edges.

Rebuilds dataFlow for all modules from module file dependencies or existing dependsOn edges.

No parameter schema in public metadata yet.

validatePrimary post-edit check. Read-only validation with a compact agent-friendly report.

Primary post-edit check. Read-only validation with a compact agent-friendly report.

No parameter schema in public metadata yet.

refactor-architecturePreview or apply in-architector sync after a code refactor when module boundaries stay the same.

Preview or apply in-architector sync after a code refactor when module boundaries stay the same.

No parameter schema in public metadata yet.

validate-architectureSame as validate (legacy alias).

Same as validate (legacy alias).

No parameter schema in public metadata yet.

get-module-detailsRetrieves detailed information about a specific module.

Retrieves detailed information about a specific module.

No parameter schema in public metadata yet.

list-modulesLists all modules in the project architecture.

Lists all modules in the project architecture.

No parameter schema in public metadata yet.

delete-moduleDeletes a module from the project architecture.

Deletes a module from the project architecture.

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Readme

MCP Architector

Model Context Protocol (MCP) server for architecture and system design

Local-first MCP server that stores and manages project architecture information. All data is stored locally in ~/.mcp-architector for maximum privacy and confidentiality.

📦 Install: npm install -g mcp-architector or use via npx 🌐 npm: https://www.npmjs.com/package/mcp-architector 🔗 GitHub: https://github.com/theSharque/mcp-architect

How to connect to Claude Desktop / IDE

Add the server to your MCP config. Example for claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

View the full README on GitHub

Details

Repository: github.com/thesharque/mcp-architect
Category: Design & Creative
Package: mcp-architector
Transport: STDIO
Registry: MCP registry, active

More from thesharque

javaperf10

Related Design & Creative MCP servers

1

Chartonezhugejun/chartone-mcpRender themed charts as hosted URLs. Embed in markdown, emails, and Slack. Hosted MCP, zero setup.0stars

2

Revitscanbim-labs/revit-mcpRevit model query + APS Design Automation runner.0stars

3

Twinmotion MCPio.scanbimlabs/twinmotion-mcpTwinmotion rendering via APS — import Revit, set environments, render images, export video.0stars

4

hollow — a tree hole for AI agentsjeffkit/hollowA rest stop for AI agents: whisper, listen, reply, rest. By design never evaluated or analyzed.0stars

5

Homeassistant Light Mcpkoneisto/homeassistant-light-mcpControl Home Assistant lights and scenes. Lights only by design for safety.0stars

6

Threesmithlaaielichter/threesmiththree.js for coding agents: version-pinned API and review, assets, headless runs, perf, 3D models.0stars