@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

Project-level (recommended for teams)

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.

Global (available in all projects)

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 git@github.com: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