Optimized Memory MCP Server v2
About
This is a personal project to test Claude AI's ability to self-write an MCP Server code for its own use.
Details
- Author
- AgentWong
- Downloads
- 346
- Categories
- Knowledge Base
Jump to
- MCP resources for entity, provider, and Ansible collection management
- MCP tools for entity creation, observation, and provider registration
- Full-text search across tracked infrastructure components
- SQLite database with connection pooling and automatic cleanup
- Comprehensive error handling and extensive logging
- Full Claude Desktop compatibility via FastMCP
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Optimized Memory MCP Server v2Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, set up a Python environment (Python 3.13.1+), install dependencies with pip install -r requirements.txt, configure the database URL via the DATABASE_URL environment variable, run database migrations with alembic upgrade head, then start the server with uvx run python -m src.main. In Claude Desktop, set the MCP server URL to http://localhost:8000 and enable the MCP protocol in settings.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"optimized memory mcp server v2": {
"optimized-memory-mcp-serverv2": {
"command": "uvx",
"args": [
"run",
"python",
"-m",
"src.main"
]
}
}
}
}McpServers
{
"optimized-memory-mcp-serverv2": {
"command": "uvx",
"args": [
"run",
"python",
"-m",
"src.main"
]
}
}Optimized Memory MCP Server v2
A high-performance Python-based Model Context Protocol (MCP) server implementation optimized for Claude Desktop integration. This server provides efficient memory management and robust infrastructure component tracking capabilities.
> [!CAUTION]
> This project has been archived due to faulty project specifications and AI direction that led to endless looping behavior.
Overview
This MCP server implementation focuses on:
- Efficient memory management for large-scale infrastructure tracking
- Comprehensive resource and tool implementations following MCP patterns
- Full Claude Desktop compatibility
- SQLite-based persistent storage with connection pooling
- Robust error handling and resource cleanup
Features
- MCP Resources
- Entity management (listing, retrieval, relationships)
- Provider resource tracking
- Ansible collection management
- Version tracking
- Full-text search capabilities
- MCP Tools
- Entity creation and management
- Observation tracking
- Provider registration
- Ansible module integration
- Infrastructure analysis tools
- Core Components
- FastMCP server implementation
- SQLite database with connection pooling
- Comprehensive error handling
- Automatic resource cleanup
- Extensive logging
Project Structure
.
├── src/
│ ├── resources/ # MCP resource implementations
│ ├── tools/ # MCP tool implementations
│ ├── db/ # Database management
│ ├── utils/ # Utility functions
│ └── server.py # Main server implementation
├── tests/
│ ├── resources/ # Resource tests
│ ├── tools/ # Tool tests
│ └── integration/ # Integration tests
├── docs/ # Documentation
├── migrations/ # Database migrations
└── requirements/ # Project dependencies
Requirements
- Python 3.13.1 or higher
- SQLite 3.x
- uvx server
Quick Start
See our Environment Setup Guide for detailed installation instructions.
Key steps:
1. Clone and setup Python environment
2. Install dependencies: pip install -r requirements.txt
3. Configure database: export DATABASE_URL=sqlite:///path/to/db.db
4. Initialize database: alembic upgrade head
5. Start server: uvx run python -m src.main
Usage
1. Start the server:
uvx run python -m src.main
2. Configure Claude Desktop:
- Set MCP server URL to http://localhost:8000
- Enable MCP protocol in Claude settings
3. Verify connection:
curl http://localhost:8000/health
Development Setup
1. Install development dependencies:
pip install -r requirements-dev.txt
2. Set up pre-commit hooks:
pre-commit install
3. Run tests:
pytest
4. Check code quality:
flake8
mypy .
Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes following our conventions
4. Run tests and linting
5. Submit a pull request
Documentation
- Environment Setup Guide - Installation and configuration
- MCP Usage Guide - Using MCP resources and tools
- API Documentation - API reference
- Configuration Guide - Server configuration
- Development Guide - Contributing guidelines
- Database Schema - Data model reference
- Troubleshooting Guide - Common issues and solutions
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- Claude Desktop team for MCP protocol specifications
- Contributors to the FastMCP library
- SQLAlchemy team for database tooling
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
