optimized-memory-mcp-serverv2

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: bash uvx run python -m src.main

2. Configure Claude Desktop:

3. Set MCP server URL to http://localhost:8000

4. Enable MCP protocol in Claude settings

5. Verify connection: bash curl http://localhost:8000/health

Development Setup

1. Install development dependencies: bash pip install -r requirements-dev.txt

2. Set up pre-commit hooks: bash pre-commit install

3. Run tests: bash pytest

4. Check code quality: bash 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