Heimdall MCP Server provides long-term memory for AI coding assistants. It benefits developers and operations teams by maintaining context across sessions. It connects to Claude-based agents and integrates with existing development workflows.
git clone https://github.com/lcbcFoo/heimdall-mcp-server.gitHeimdall MCP Server solves the problem of AI coding assistants starting each session with no memory of your codebase or previous conversations. It maintains a persistent, project-specific knowledge base by indexing your documentation, git history, and development insights, then makes this context available through the Model Context Protocol. The system uses Qdrant vector search and SQLite metadata storage to efficiently retrieve relevant memories when your LLM queries the system. Developers and operations teams benefit from an AI assistant that understands architectural patterns, past solutions, and project-specific context across multiple sessions.
[{"step":"Define a clear label for your context (e.g., 'project_config_v1'). Use concise, descriptive names like 'api_endpoints_2024' or 'debugging_steps_issue_123'.","tip":"Labels should be unique and avoid spaces or special characters. Prefix with a domain like 'frontend_' or 'backend_' for better organization."},{"step":"Store context using the heimdall-mcp-server command: 'Store the following context with label [LABEL]: [CONTENT]'. Include all relevant details like versions, configurations, or troubleshooting steps.","tip":"For large contexts (e.g., entire project configs), break them into smaller chunks and store them under related labels (e.g., 'frontend_deps', 'backend_deps')."},{"step":"Retrieve context in future sessions using: 'Retrieve the context labeled [LABEL]'. The server will return the stored data in a structured format.","tip":"Use the 'list' command to see all available labels if you forget the exact name. Example: 'List all stored context labels'."},{"step":"Update context by reusing the same label with new content. The server will overwrite the previous entry, ensuring you always have the latest information.","tip":"Add a 'last_updated' timestamp and brief notes to track changes over time. Example: 'Added axios for API calls; removed deprecated request library'."},{"step":"Integrate with your workflow by automating context storage. For example, use a pre-commit hook to store the latest project state before pushing changes.","tip":"Combine with CI/CD tools like GitHub Actions to ensure context is stored alongside code changes. Example: 'Store context with label project_state_after_commit_[SHA]'."}]
Maintaining context across multiple coding sessions without losing project history
Indexing git commit history to understand codebase evolution and architectural decisions
Automatically loading and monitoring documentation for instant LLM access
Preventing context leakage between projects with isolated memory spaces
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/lcbcFoo/heimdall-mcp-serverCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Use the heimdall-mcp-server to [ACTION: retrieve/store/update] the following context for my coding assistant: [CONTEXT: e.g., 'the project's dependencies, recent debugging steps, or API endpoints used']. Ensure this context persists across sessions and is accessible for future interactions. If storing new context, include a brief label like [LABEL: e.g., 'project_dependencies_2024'] for easy retrieval.
```json
{
"status": "success",
"action": "retrieved",
"context": {
"label": "project_dependencies_2024",
"content": {
"dependencies": {
"react": "^18.2.0",
"express": "^4.18.2",
"lodash": "^4.17.21",
"axios": "^1.6.2"
},
"devDependencies": {
"jest": "^29.7.0",
"webpack": "^5.89.0",
"eslint": "^8.56.0"
},
"last_updated": "2024-05-15",
"notes": "Added axios for API calls; removed deprecated 'request' library"
}
},
"usage_tip": "This context is now available for all future sessions. To update, use the same label with new content."
}
```
The heimdall-mcp-server successfully retrieved the stored context for the project's dependencies. The data shows React 18.2.0 as the frontend framework, Express 4.18.2 for the backend, and Axios 1.6.2 for HTTP requests—replacing the older 'request' library. Jest and Webpack are configured for testing and bundling, respectively, while ESLint enforces code quality. The last update was on May 15, 2024, with a note about the axios migration. This context will persist even if the session restarts, allowing the AI assistant to reference these dependencies in future debugging or feature development tasks without reproviding the information.Affordable direct air carbon capture
Get more done every day with Microsoft Teams – powered by AI
Automate security compliance and monitor real-time security posture seamlessly.
Automate your spreadsheet tasks with AI power
Agentic AI Workflow platform
Connected workspace for docs, wikis, and projects
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan