@myohsat/dev-assistant-mcp

An MCP server that analyzes any codebase and generates structured context for AI assistants. Instead of manually writing CLAUDE.md or cursor rules, let the AI understand your project automatically.

Quick Start

npx -y @myohsat/dev-assistant-mcp

Tools

Context Generation

| Tool | Description | | --------------------- | ------------------------------------------------------------------------------------------------------------------------- | | generate_context | Generate a complete project context document — tech stack, architecture, conventions, scripts. This is the main tool. | | analyze_project | Detect tech stack, framework, package manager, project type, and dependency counts. | | map_architecture | Scan directory structure and identify architectural layers (routing, logic, data, UI, etc.) and patterns. | | extract_conventions | Read config files and extract coding conventions — TypeScript strictness, formatting rules, linting setup. |

Utilities

| Tool | Description | | ------------- | ------------------------------------------------------------------- | | read_file | Read the contents of a file at a given absolute path. | | search_code | Search for a text or regex pattern across all files in a directory. |

Setup

Claude Code

Add .mcp.json to your project root:

{
  "mcpServers": {
    "dev-assistant": {
      "command": "npx",
      "args": ["-y", "@myohsat/dev-assistant-mcp"]
    }
  }
}

This makes the MCP server available only in this project. Commit the file so your team gets it too.

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "dev-assistant": {
      "command": "npx",
      "args": ["-y", "@myohsat/dev-assistant-mcp"]
    }
  }
}

This makes the MCP server available in every Claude Code session.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dev-assistant": {
      "command": "npx",
      "args": ["-y", "@myohsat/dev-assistant-mcp"]
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Add to Cursor Settings > MCP:

{
  "mcpServers": {
    "dev-assistant": {
      "command": "npx",
      "args": ["-y", "@myohsat/dev-assistant-mcp"]
    }
  }
}

VS Code (Copilot)

Add .vscode/mcp.json to your project:

{
  "servers": {
    "dev-assistant": {
      "command": "npx",
      "args": ["-y", "@myohsat/dev-assistant-mcp"]
    }
  }
}

What It Detects

Tech Stack: Node.js ecosystems — npm, yarn, pnpm, bun. TypeScript and JavaScript. Frameworks including Express, Fastify, NestJS, Next.js, Nuxt, React, Vue, Svelte, Angular, and more.

Architecture: Directory structure up to 3 levels deep. Classifies folders into layers: routing, logic, data, middleware, UI, config, tests, utilities. Detects patterns like MVC, middleware pipelines, and feature-based organization.

Conventions: TypeScript compiler options (strict mode, module system, target). Prettier formatting rules (quotes, semicolons, indentation). ESLint config format. EditorConfig settings. Module type (ESM/CJS) and engine constraints.

Development

git clone [email protected]:MyoHsat27/dev-assistant-mcp.git
cd dev-assistant-mcp
npm install

| Script | Description | | ------------------- | --------------------------- | | npm run dev | REST server with hot reload | | npm run dev:mcp | MCP server via stdio | | npm run build | Compile TypeScript | | npm run typecheck | Type check without emitting | | npm run lint | Run ESLint | | npm run format | Format with Prettier |

License

MIT