Install for Windsurf IDE

Prerequisites

• Node.js 18 or higher

  Download from nodejs.org

• Windsurf IDE

  Download from codeium.com/windsurf

• ContextForge Account

  Create a free account

Step 1: Install ContextForge MCP

Open your terminal and run:

npm install -g contextforge-mcp

Step 2: Verify Installation

# Check if contextforge-mcp is installed
which contextforge-mcp

# Should output the path to the executable

Step 3: Configure Windsurf

# macOS
~/.codeium/windsurf/mcp_config.json

# Windows
%USERPROFILE%\.codeium\windsurf\mcp_config.json

# Linux
~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "contextforge": {
      "command": "contextforge-mcp",
      "env": {
        "CONTEXTFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Using ContextForge in Windsurf

Once configured, you can use ContextForge tools in Windsurf's Cascade AI:

# Save knowledge to memory
"Remember this API endpoint documentation..."

# Query your memory
"What do we know about the authentication flow?"

# Create tasks
"Create a task: Fix the login bug"

# List your tasks
"Show my pending tasks"

Updating ContextForge MCP

When a new version is available, you can update with:

npm install -g contextforge-mcp

After updating, restart Windsurf for changes to take effect.

Troubleshooting

# Validate JSON syntax
cat ~/.codeium/windsurf/mcp_config.json | jq .

# Check if contextforge-mcp is accessible
which contextforge-mcp

# Find the full path
npm config get prefix

# Use full path in mcp_config.json
{
  "mcpServers": {
    "contextforge": {
      "command": "/usr/local/bin/contextforge-mcp",
      "env": {
        "CONTEXTFORGE_API_KEY": "your-api-key"
      }
    }
  }
}

Next Steps