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:
- Clone and setup Python environment
- Install dependencies:
pip install -r requirements.txt - Configure database:
export DATABASE_URL=sqlite:///path/to/db.db - Initialize database:
alembic upgrade head - Start server:
uvx run python -m src.main
Usage
-
Start the server:
uvx run python -m src.main -
Configure Claude Desktop:
- Set MCP server URL to
http://localhost:8000 - Enable MCP protocol in Claude settings
- Set MCP server URL to
-
Verify connection:
curl http://localhost:8000/health
Development Setup
-
Install development dependencies:
pip install -r requirements-dev.txt -
Set up pre-commit hooks:
pre-commit install -
Run tests:
pytest -
Check code quality:
flake8 mypy .
Contributing
- Fork the repository
- Create a feature branch
- Make your changes following our conventions
- Run tests and linting
- 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