Cursor Integration
Add persistent memory to Cursor, the AI-powered code editor.
About Cursor
Cursor is a VS Code fork with built-in AI capabilities. It supports MCP (Model Context Protocol), allowing ekkOS to provide context that persists across editing sessions and even across different projects.
Configuration
Step 1: Create MCP configuration file
Create a file called .cursor/mcp.json in your project root:
├── .cursor/
│ └── mcp.json ← Create this file
├── src/
└── package.json
Step 2: Add ekkOS configuration
Add the following to your mcp.json:
{
"mcpServers": {
"ekkos-memory": {
"command": "npx",
"args": ["-y", "@ekkos/mcp-server"],
"env": {
"EKKOS_API_KEY": "your_api_key_here"
}
}
}
}Step 3: Enable MCP in Cursor
- 1Open Cursor Settings (Cmd/Ctrl + ,)
- 2Search for "MCP"
- 3Enable "Use MCP Servers"
Step 4: Reload Window
Press Cmd/Ctrl + Shift + P and runDeveloper: Reload Window
Global vs Project Configuration
Project-level (Recommended)
.cursor/mcp.json in each project
- • Different API keys per project
- • Share config with team via git
- • Project-specific memory
Global
~/.cursor/mcp.json
- • Same memory across all projects
- • One-time setup
- • Cross-project learning
Verify Installation
Open Cursor's AI chat and ask:
"Search my memory for patterns in this codebase""What context do you have about this project?"If you see tool calls like mcp__ekkos-memory__ekko, the integration is working.
Tips for Cursor
Use Composer Mode
Cursor's Composer mode works best with ekkOS. It can use memory tools while generating multi-file changes, ensuring consistency with your established patterns.
Ask for Memory Explicitly
Start complex tasks with "Search my memory for..." to ensure relevant patterns are loaded. This is especially useful for recurring problems.
Crystallize Important Decisions
After making architectural decisions, tell Cursor to "Remember this for future reference" or "Crystallize this pattern". This ensures the knowledge persists.
Troubleshooting
MCP not appearing in tool list?
- • Ensure "Use MCP Servers" is enabled in settings
- • Check that mcp.json is in the correct location
- • Reload the window after changes
Connection errors?
- • Verify your API key at platform.ekkos.dev
- • Check Node.js 18+ is installed
- • Look for errors in Cursor's Output panel (MCP Servers)