cursor.md

NCP Setup for Cursor

🚀 Quick Setup

Step 1: Install NCP

npm install -g @portel/ncp

Step 2: Configure MCP Server

Global configuration:

~/.cursor/mcp.json

Project-specific:

<project-root>/.cursor/mcp.json

Configuration:

{
  "mcpServers": {
    "ncp": {
      "command": "ncp"
    }
  }
}

Step 3: Restart Cursor

Close and reopen Cursor IDE.

---

📖 Official Documentation

For complete Cursor MCP setup, troubleshooting, and features:

📚 Official Cursor MCP Guide

---

⚙️ NCP-Specific Configuration

Using Profiles

Separate work and personal MCPs:

{
  "mcpServers": {
    "ncp-work": {
      "command": "ncp",
      "env": {
        "NCP_PROFILE": "work"
      }
    },
    "ncp-personal": {
      "command": "ncp",
      "env": {
        "NCP_PROFILE": "personal"
      }
    }
  }
}

Debug Logs

Enable logging to ~/.ncp/logs/:

{
  "mcpServers": {
    "ncp": {
      "command": "ncp",
      "env": {
        "NCP_DEBUG": "true"
      }
    }
  }
}

Custom Working Directory

{
  "mcpServers": {
    "ncp": {
      "command": "ncp",
      "env": {
        "NCP_WORKING_DIR": "/path/to/workspace"
      }
    }
  }
}

---

💡 What NCP Provides

• ncp_find - Semantic search across all your MCPs
• ncp_run - Execute any tool with proper parameter handling

Result: 90%+ token savings, longer conversations, just-in-time tool loading.

---

Need help? Troubleshooting Guide | Open an issue