Installation & Quick Start

MCP Installation & Quick Start

Get LogicStamp Context MCP server up and running in minutes. Works with Claude Desktop, Claude Code, and any MCP-compatible client.

Prerequisites

Node.js 18.18.0 or higher
LogicStamp Context CLI - The stamp command must be installed and available in PATH

npm install -g logicstamp-context

Installation

For Claude Code Users

LogicStamp MCP server works with Claude Code - Anthropic's official CLI for Claude.

Option 1: Global Installation (Recommended)

Install globally to use LogicStamp in all your projects:

# Install the package
npm install -g logicstamp-mcp

# Add to Claude Code - available everywhere
claude mcp add --scope user --transport stdio logicstamp -- npx logicstamp-mcp

What this does: Adds LogicStamp to your global Claude Code configuration (~/.claude.json), makes the 6 LogicStamp tools available in every project, and server auto-starts when Claude Code needs it (no manual startup required).

Option 2: Per-Project Installation (For Teams)

Install per-project to share configuration with your team via git:

# Install the package
npm install -g logicstamp-mcp

# In your project directory
cd /path/to/your/project
claude mcp add --scope project --transport stdio logicstamp -- npx logicstamp-mcp

What this does: Creates .mcp.json in your project root, can be committed to git for team collaboration, and team members get the same MCP configuration.

Example .mcp.json:

{
  "mcpServers": {
    "logicstamp": {
      "type": "stdio",
      "command": "npx",
      "args": ["logicstamp-mcp"]
    }
  }
}

Option 3: Local Development

For contributors or if you're developing the MCP server locally:

# Clone and build
git clone https://github.com/LogicStamp/logicstamp-mcp.git
cd logicstamp-mcp
npm install
npm run build

# Add via CLI (replace with your actual path)
claude mcp add --scope user --transport stdio logicstamp -- node /absolute/path/to/logicstamp-mcp/dist/index.js

# On Windows:
claude mcp add --scope user --transport stdio logicstamp -- node C:\Users\YourName\path\to\logicstamp-mcp\dist\index.js

For Claude Desktop Users

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "logicstamp": {
      "command": "npx",
      "args": ["logicstamp-mcp"]
    }
  }
}

For Cursor Users

Add to your Cursor MCP config (~/.cursor/mcp.json on macOS/Linux or %USERPROFILE%\.cursor\mcp.json on Windows):

{
  "mcpServers": {
    "logicstamp": {
      "command": "npx",
      "args": ["logicstamp-mcp"]
    }
  }
}

After adding the config, fully quit and restart Cursor (not just close the window) for changes to take effect. Verify in Settings → Features → Model Context Protocol.

For Other MCP Clients

For any MCP-compatible client:

npx logicstamp-mcp

The server communicates via stdio and will automatically connect to the client.

All product names, framework names, and trademarks are the property of their respective owners. LogicStamp is an independent open-source project and is not affiliated with or endorsed by the listed AI assistants, tools, or frameworks.

Verifying Installation

After installation, verify the server is configured:

claude mcp list

You should see:

Checking MCP server health...

logicstamp: npx logicstamp-mcp - ✓ Connected

Quick Start

Once installed, start using LogicStamp in your React/TypeScript project:

cd /path/to/your/react-project
claude

Ask your AI assistant to analyze your codebase:

You:

"Use LogicStamp to analyze the components in src/components"

AI Assistant:

[Automatically uses logicstamp_refresh_snapshot and logicstamp_list_bundles]

The 6 LogicStamp tools will be available:

logicstamp_refresh_snapshot - Analyze project structure
logicstamp_list_bundles - List available components
logicstamp_read_bundle - Read component contracts
logicstamp_compare_snapshot - Detect changes after edits
logicstamp_compare_modes - Generate token cost comparison
logicstamp_read_logicstamp_docs - Read LogicStamp documentation

Ready to Use LogicStamp MCP?

Check out the MCP Reference for detailed tool documentation, or explore the overview page to learn more about how it works.

MCP Reference MCP Overview