npm install -g @portel/ncpConfig file location:
# macOS/Linux
~/.codeium/windsurf/mcp_config.json
# Windows
%USERPROFILE%\.codeium\windsurf\mcp_config.jsonOr use Windsurf UI: Settings (Cmd/Ctrl + ,) → Advanced Settings → Cascade → Manage MCP Servers → View raw config
Configuration:
{
"mcpServers": {
"ncp": {
"command": "ncp"
}
}
}Close and reopen Windsurf IDE.
For complete Windsurf MCP setup, Cascade features, and troubleshooting:
📚 Windsurf Configuration Tutorial
Separate work and personal MCPs:
{
"mcpServers": {
"ncp-work": {
"command": "ncp",
"env": {
"NCP_PROFILE": "work"
}
},
"ncp-personal": {
"command": "ncp",
"env": {
"NCP_PROFILE": "personal"
}
}
}
}Enable logging to ~/.ncp/logs/:
{
"mcpServers": {
"ncp": {
"command": "ncp",
"env": {
"NCP_DEBUG": "true"
}
}
}
}{
"mcpServers": {
"ncp": {
"command": "ncp",
"env": {
"NCP_WORKING_DIR": "/path/to/workspace"
}
}
}
}ncp_find- Semantic search across all your MCPsncp_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