Skip to main content

​
Prerequisites

  • Node.js v18+ and npm
  • An IDE with MCP support

​
Install

npm install -g codearchitect-mcp

​
Configuration by Coding Agent

​
Method 1: Using Cursor Settings UI

  1. Open Cursor (the code editor)
  2. Click the gear icon ⚙️ in the bottom left corner (or press Ctrl+, on Windows/Linux, Cmd+, on Mac)
  3. In Settings search box, type: “MCP” or “Model Context Protocol”
  4. Click on “Tools & MCP” section
  5. Click “Add Server” or the + button
  6. Fill in the form:
    • Name: codearchitect
    • Command: npx
    • Args: -y codearchitect-mcp@latest
  7. Click Save or OK

​
Method 2: Manual Config File

  1. Close Cursor
  2. Navigate to your home folder:
    • Windows: C:\Users\YourName\.cursor\ (create .cursor folder if needed)
    • Mac/Linux: ~/.cursor/ (create .cursor folder if needed)
  3. Create a file named mcp.json in that folder
  4. Open it in a text editor and paste:
{
  "mcpServers": {
    "codearchitect": {
      "command": "npx",
      "args": ["-y", "codearchitect-mcp@latest"]
    }
  }
}
  1. Save the file and open Cursor again

​
Verify Setup

  1. Check the bottom status bar - you should see “MCP” or “codearchitect” with a green dot (connected)
  2. Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)
  3. Type “Reload Window” and press Enter
  4. Open any chat/conversation in Cursor
  5. Type: use codearchitect
  6. You should see a list of features and workflow guide

​
Export Chat

To save conversations:
  1. In Cursor chat, click the three dots menu (⋯) in the top right corner
  2. Click “Export Chat”
  3. Navigate to: C:\Users\YourName\.codearchitect\exports\ (Windows) or ~/.codearchitect/exports/ (Mac/Linux)
    • Create the exports folder if it doesn’t exist
  4. Click Save (file will be saved as .md format)

​
Verify

After configuration, test CodeArchitect MCP by asking your AI assistant: 
use codearchitect
This should show you all available features. Check that codearchitect_help, store_session, and get_session appear in your IDE’s available tools list. See Troubleshooting if issues occur.